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Preface 


This manual is one in a series designed to instruct and guide the SPERRY MAPPER 80 
user. It specifically describes the formats and guidelines for MAPPER 80 run functions. 
Runs are an efficient and convenient way of executing sets of MAPPER 80 run functions 
and are especially useful in repetitive processing. 


A prerequisite for this manual is the manual functions user guide, UP-9735 (current 
version). 


The MAPPER 80 library also includes current versions of the following manuals: 
= MAPPER 80 manual functions user guide, UP-9735 

Describes all the manual functions and how they manipulate reports or data. 
= MAPPER 80 forms generation and utilities user guide, UP-9736 

Describes the MAPLOD, MAPLST, and MAPDMS utilities. 
= MAPPER 80 system operator and coordinator guide, UP-9737 


Discusses MAPPER 80 operations, including system generation and data base 
system coordination. 


This manual is divided into six sections and three appendixes: 
= Section 1. INTRODUCTION TO RUN FUNCTIONS 


Provides an overview of what is required for run creation, debugging, registration, 
and execution using the MAPPER 80 run functions. 
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m Section 2. CONVENTIONS AND RUN DESIGN CONSIDERATIONS 





Describes the format, syntax, and parameters making up the run functions. 
mw Section 3. PROCESSING REPORTS AND RESULTS 

Describes the four data types that are processed by the run functions. 
mw Section 4. WORKSTATION OPERATION 


Shows the various methods for starting and executing the run created and 
registered in the system. 


m Section 5. MAPPER 80 RUN FUNCTIONS 


Alphabetically lists the run functions and describes their use and format. Examples 
are also provided. 


m Section 6. RUN CREATION EXAMPLE 
Gives a walk-through of a run using the MAPPER 80 run functions. 


m Appendix A. RUN FUNCTION SUMMARY 





Classifies the various run functions in a run function summary. 
m= Appendix B. OPTIONS TABLE 
Lists the options of the run function's option parameter. 


m= Appendix C. CORRESPONDENCE BETWEEN RUN FUNCTIONS AND MANUAL 
FUNCTIONS 


Shows the correspondence between the run functions and the manual functions. 
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1. Introduction 


1.1. GENERAL 


A run is a MAPPER 80 report consisting of a set of run functions that specify 
step-by-step instructions for generating reports or results. Runs are an efficient and 
convenient way of executing sets of MAPPER 80 functions and are especially useful for 
repetitive processing, since they provide both report-generating as well as automatic 
data base updating capabilities. In run design, you have complete formatting flexibility. 


You can intersperse the selected functional run sequence with logical decisions (e.g., 
branching) made on results produced or on variables accumulated in main storage. You 
can design runs for use in tutorial mode, thus allowing sequential interruption for display 
and interactive control. 


You can specify most manual functions in a run report. A run report contains the 
specific run functions for a given run. Additional run functions with no manual function 
counterpart are available. Refer to Section 6 for examples of run reports and to the 
manual functions user guide, UP-9735, for further information on manual functions. 


Figure 1—1 is a configuration showing run processing versus manual processing. Both 
methods process the same input, execute the equivalent functions, and produce the 
same output. However, run processing is more efficient. 


UP-9734 


RUN PROCESSING 


RUN-NAME 
INPUT 


RUN EXECUTION 


SEARCH 
SORT 
PRINT 


PRINTED 
RESULT 
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MANUAL FUNCTION PROCESSING 






SEARCH FUNCTION 
S xx 























PARAMETER 
INPUT 
FOR SORT 


PARAMETER 






INPUT 
FOR SEARCH 
RESULT 
IS 
DISPLAYED 


RESULT 
IS 
DISPLAYED 


PRINT FUNCTION 
PR 






SORT FUNCTION 
SORT 





PARAMETER 
INPUT FOR 
PRINT 


PRINTED 
RESULT 


Figure 1-1. Run versus Manual Processing 


1.2. CREATION, REGISTRATION, AND EXECUTION OF A RUN 


To use a run function, you must carry out registration, creation, and execution of work 


in that order. Figure 1~2 shows these operations. 


REGISTRATION 
AND CREATION 


PLAN THE RUN 


DEFINE THE 
RUN NAME 


REGISTER 


THE RUN NAME 


CREATE 


THE 
RUN 





EXECUTION 









RUN THE 
REGISTERED 
REPORT 


RUN REPORT 


PROCESSING 
PROCEDURE 











WORKSTATION 


PRINTER 


Figure 1-2. Creation, Registration, and Run Execution (Part 1 of 2} 
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LEGEND: 


Starts the run by specifying the run name via the workstation 


MAPPER 80 software checks whether the run name is registered. 


If registered, the run is processed according to the corresponding run report. 


OOO@ 


Processing results are output to the workstation or printer according to run functions. 


Figure 1-2. Creation, Registration, and Run Execution (Part 2 of 2) 


1.3. COMPARING RUN FUNCTIONS AND MANUAL FUNCTIONS 


The MAPPER 80 software enables efficient processing of runs containing several 
complex functions. However, there are fundamental differences between executing run 
functions and manual functions. 


Runs that contain several functions may put a severe load on the system. In a run, 
where function execution is performed rapidly, virtually no pauses occur between each 
of the run functions. Thus, your response time may be affected. With manual updating, 
natural pauses between transmissions disperse the processing load. 


Refer to Appendix C for the run functons and their counterpart manual functions. 
1.4. CREATION AND RUN REGISTRATION 


1.4.1. Run Creation Procedures 


The person creating and using run functions must: 


1. Create a run plan specifying the object of your run, the amount of data to be 
processed, and the run functions and processing outline. 


2. Submit the plan to the MAPPER 80 coordinator. 


3. The MAPPER 80 coordinator evaluates the plan and, if acceptable, registers the run 
report (RID number) and run name in the system and permits the user to create the 
run. 


On the other hand, if the possibility exists that the run may affect the system in a 
negative way, the user may have to reassess the plan. There are also times when 
conditional permission may be given such as specifying the time of day when the 
run can be executed. 
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4. Create the run and carry out debugging. 





5. After debugging is completed and the run is ready, evaluate the run with the 
coordinator. 


6. If the evaluation results are not satisfactory, reevaluations occur after analysis and 
revisions. If the results are satisfactory, register the run for use. Figure 1-3 
provides a flowchart of the run creation and registration procedure. 







CREATE THE 
RUN PLAN 










SUBMIT TO 
MAPPER 80 
COORDINATOR 





APPROVED 
? 





REASSESS 














REGISTER 
FOR DEBUGGING 


CREATION OF 
RUN AND 
DEBUGGING 


EVALUATION 


ANALYSIS/ 
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REGISTER 
FOR USE 
AVAILABLE 
FOR USE 


Figure 1-3. Run Creation/Registration Flowchart 
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1.4.2. Run Registration Guidelines 


The run is registered after coordinator approval. Run registration includes the run name, 
mode, type, and report identity (RID) of the run being entered, as well as security and 
workstation identity number. 


1.4.2.1. Run Name 

The run name is the identifier used when executing a run. The name must be 12 or 
fewer characters. The first character must be alphabetic. The name cannot be one of 
the MAPPER 80 reserved words or a name that is already registered in the same 
department (e.g., the department number used when signing on). 

1.4.2.2. Mode, Type, and RID 

The mode, type, and RID (report identification) identify the specific report you want to 
access in your run. You can specify a maximum of five modes (current mode of the run, 
plus four additional modes) that a run can access. 

1.4.2.3. Security Specifications 


Security requires that you: 


m Include the user identifier only when limiting the execution of a run to a specific 
user identifier 


m Include the workstation number only when limiting execution of a run to a specific 
workstation 


1.4.3. Support Function Considerations in Designing a Run 


When designing the run, you need to know the field number, first column number, 
number of columns in each field, and the line length in the specified report. You can use 
the manual functions FLD (1.4.3.1) and CC (1.4.3.2) to display these items. 


1.4.3.1. Using the FLD Manual Function to Display Report Fields 


The FLD manual function displays the field number of each field of a report. To use this 
function, display the report you want on the screen. Key in FLD on line O as the 
function name and press the transmit key. If you input this function name when there is 
a hold line on the screen, an error message results. 
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1-6 























line OS® LINE> € 
. DATE 
» «<< 
xST.ORD 
«CD .NUM 








OR 999 
OR 959 


When FLD executes, the report displayed after line O moves down (rolls down) three 
lines and the field number of each field is indicated in the space between lines 1 and 3. 


1d FMT> RL> SHFT> 
83/07/05 09:29:51 TYPE=D RID=001 


CORPORATE ORDER STATUS 
ER . PRODUCT .ODR.CUST. 
BER. TYPE -QTY.CODE. 


51S. GREENBOX9 2 “AMCO. 


OR 999515 GREENBOX7 1 AMCO 


51S BLACKBOX9 1 AMCO 


>>> 


HLD CHR> HLD LN> 
83/06/29 JDOE 


UNIT .EXTENDED.REQ'D .SALE. 
RETAIL . RETAIL .DELIVR.REP . 


PSWD> > 
< 20 LINES> 


CUSTOMER 


"750312. DJR “AMERIAN OIL CO. "93 
750312 DJR AMERIAN OIL CO. 73 
750312 DJR AMERIAN OIL CO. 73 


The three lines that display the field numbers are then automatically held. 





























LINE> 1 
*FIELD 


1 2 
- DATE 
<<< 





OR 96652S BLACKBOX5 
OR 96652S BLACKBOX4 
OR 99753S GREENBOX5 


SHFT> 


6 


HLD CHR> HLD LN> 


7 


FMT> RL> 
NUMBER 
3 4 5 
83/07/05 09:29:51 TYPE=D RID=001 


CORPORATE ORDER STATUS 


*ST.ORDER . PRODUCT .ODR.CUST. 
*CD.NUMBER. TYPE -QTY. CODE. 
Kea, Sssses. SPST SPSSrSee SSS LSS TS LS SST SS SST SSS GSS, ee ee 
OR 99951S GREENBOX9 2 AMCO 
OR 99951S GREENBOX7 1 
OR 99951S BLACKBOX9 1 
OR 966528 GREENBOX4 2 ARCO 
1 
1 
1 


>>> 
UNIT 


RETAIL . 


. EXTEN 
RETA 


8 9 
83/06/29 JDOE 


DED.REQ'D .SALE. 
IL .DELIVR.REP . 


750312 DJR 
750312 DJR 
750312 DJR 
750412 LSJ 
780412 LSJ 
750412 LSJ 
750312 LSJ 


3. PSWD> 


~ 


CUSTOMER 


AMERIAN OIL CO. 
AMERIAN OIL CO. 
AMERIAN OIL CO. 
ARGENTINE CORP. 
ARGENTINE CORP. 
ARGENTINE CORP. 
DIGITAL CORP 





To view the horizontal portion of the report not displayed on the screen, move the 
cursor to the SHFT field on line O and key in the number of columns to shift, then press 


























the transmit key. 
LINE> 1 FMT>  RL> SHFT > HLD CHR> HLD LN> 3 PSWD> > 
* 
1 1 1 1 1 
1 Z 3 4 5 
.DATE 83/07/05 09:29:51 TYPE=D RID=001 83/06/29 JDOE < 20 LINES> 
. <<< CORPORATE ORDER STATUS >>> 
x, ; : 
*. ADDRESS : CITY “STATE. ZIP .REMARK. 
Kk (aeasscessssscsss, BSS te SSeS SSSsas=, SF SSSt,Sstst, Sssrs>sass 
7300 CENTRAL AV NEW ORLEANS LA 64301 
7300 CENTRAL AV NEW ORLEANS LA 64301 
7300 CENTRAL AV NEW ORLEANS LA 64301 
2300 5TH AVE NEW YORK NY 33021 
2300 STH AVE NEW YORK NY 33021 
2300 STH AVE NEW YORK NY 33021 
1782 NORTH ST NEW YORK NY 54002 
1566 COLUMBIA WASHINGTON DC 20001 
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1.4.3.2. Using the CC Manual Function to Display Report Column Numbers 

The CC manual function displays the column numbers of the report. To use this 
function, display the report you want on the screen, key in CC on line O, and press the 
transmit key. ; 


An error results if you input this function when there is a hold line on the screen. 









































LINE> cc FMT> RL> SHFT > HLD CHR> HLD LN> PSWD> > 
-DATE 83/07/05 09:29:51 TYPE=D RID=001 83/06/29 JDOE < 20 LINES> 
. <<< CORPORATE ORDER STATUS >>> 

*ST.ORDER . PRODUCT .ODR.CUST. UNIT .EXTENDED.REQ'D .SALE. 

*CD.NUMBER. TYPE -QTY.CODE. RETAIL . RETAIL .DELIVR.REP . CUSTOMER , 
kx Sasrtsaa SSeS naseSesoses === ssa Boum mmoaan mmr asses arr tas sas SPSS reseesesstrestrt= == 
OR 99951S GREENBOX9 2 AMCO 750312 DJR AMERIAN OIL CO. 73 
OR 99951S GREENBOX7 1 AMCO 750312 DJR AMERIAN OIL CO. 73 
OR 99951S BLACKBOX9 1 AMCO 750312 DJR AMERIAN OIL CO. 73 





When CC executes, the report displayed after line O moves down three lines and the 
column number is displayed in the space between lines 1 and 3. The three lines that 
display the column number are automatically held. 



































LINE> 1 FMT> RL> SHFT > HLD CHR> HLD LN> 3 PSWD> > 
xCOLUMN NUMBER 
11111111112222222222333333333344444444445555555555666666666677777777778 
123456789012345678901 2345678901 2345678901 2345678901 2345678901 2345678901 234567890 
.DATE 83/07/05 09:29:51 TYPE=D RID=001 83/06/29 JDOE < 20 LINES> 
<<< CORPORATE ORDER STATUS >>> 
*ST.ORDER . PRODUCT .ODR.CUST. UNIT .EXTENDED.REQ'D .SALE. 


*xCD.NUMBER. TYPE .QTY.CODE. RETAIL . RETAIL .DELIVR.REP . CUSTOMER 

kas a msertsoSsesszss == ==> BRR RSE ST FSM RST SS SSS SSS SSS SSS STS SSS SS SHS SST ST LSS 
OR 999515 GREENBOX9 2 AMCO 750312 DJR AMERIAN OIL CO. 73 
OR 99951S GREENBOX7 1 AMCO 750312 DJR AMERIAN OIL CO. 73 
OR 99951S BLACKBOX3 1 AMCO 750312 DJR AMERIAN OIL CO. 73 
OR 966525 GREENBOX4 2 ARCO 750412 LSJ ARGENTINE CORP. 23 
OR 96652S BLACKBOX5S 1 ARCO 750412 LSJ ARGENTINE CORP. 23 
OR 96652S BLACKBOX4 1 ARCO 780412 LSJ ARGENTINE CORP. 23 
OR 9397535 GREENBOXS 1 DICO 760312 LSJ DIGITAL CORP 17 
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To view portions not displayed on the screen, move the cursor to the SHFT field on line 
O and key in the number of columns to shift; then press the transmit key. 



























































LINE> 1 FMT> RL> SHFT> &@ HLD CHR> HLD LN> 3. PSWD> > 
x L11221222122112121121211211111111 
78888888888999999999900000000001111111111222222222 
190123456789012345678901 2345678901 2345678901 2345678 
.DATE 83/07/05 09:29:51 TYPE=D RID=001 83/06/29 JDOE < 20 LINES> 


. <<< CORPORATE ORDER STATUS >>> 
x : 


x ADDRESS : CITY .STATE. ZIP .REMARK. 
Kecosresesssscr2re=22= ho ee Sessa ,/-=3s52>55 
7300 CENTRAL AV NEW ORLEANS LA 64301 

7300 CENTRAL AV NEW ORLEANS LA 64301 

7300 CENTRAL AV NEW ORLEANS LA 64301 

2300 STH AVE NEW YORK NY 33021 

2300 STH AVE NEW YORK NY 33021 

2300 STH AVE NEW YORK NY 33021 

1782 NORTH ST NEW YORK NY 54002 





1.4.4. Guidelines for Debugging a Run 


During a run, MAPPER 80 software ignores the security features used with the manual 
functions, such as report passwords and the user identifier when replacing the reports. 
Therefore, you must thoroughly debug runs that change the contents of reports prior to 
actual use. In these cases, you debug the run without the modification steps until the 
results are thoroughly checked. 


Prepare a list of variables when you have many variables. This helps in avoiding 
duplication of definitions. 


There are also times when verification is necessary for the intermediate results, the 
details of the variables, and the processing flow for debugging runs. Inserting the 
display (@DSP) run function in key places and performing step-by-step verification is 
effective. Also include @DSP and @BRK run functions when first debugging a new run 
to prevent looping. 


Example 1: Verifying the intermediate results 


@SRH,M,T,R '' X=-XX X,V12 
aDSP,M,T,-@ 

@RNM -1. 

123456 

ABCDEF 

GHIJKL 

@BRK DSP,M,T,-® 


where M,T,R refers to the mode, type, and RID. 




















UP-9734 SPERRY OS/3 1-9 
MAPPER 80 RUN FUNCTIONS 


Example 2: Checking the details of the variables 


@FND,mode,type,rid '" X-XX X,XX V1213,V1313 
'V12'=V12 'V13'=V13 
@BRK DSP,mode, type, -@ 


NOTES: 


1. To save time when debugging, include as much test data as possible in the test 
report. This technique is better than performing line updates after the @DSP run 


function for inserting test data. 
2. To stop the run during execution, press function key F4 (also see 4.3.2). 


3. Do not free the workstation while a run is executing. Free should be performed only 
when the <IDLE> logo screen is displayed. 
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2. Conventions and Run Design 
Considerations 


2.1. GENERAL 
Runs consist of run functions, variables, and data. Comments may also be included in a 
run. If you make a syntax error when entering these, the MAPPER 80 software displays 
an error message when the run is executed. 

If column one contains: Meaning 


@ Indicates a run function. 


Specifies variable initiation. 


Other than @ or : Specifies data. This line is called an 
output line. 
@. Indicates a comment line. 


MAPPER 80 run functions and data can be entered in either uppercase or lowercase; 
however, MAPPER 80 software translates and stores all data in uppercase. 


2.1.1. Style Conventions in This Manual 


The style conventions used in this manual help make information understandable when 
you want to use MAPPER 80 software. 


The following items appear in uppercase letters: 
m= MAPPER 80 run functions, preceded by an at sign (@), for example, @CHG, @TOT 
m Reserved words (e.g., INPUT$) 


In text, user entries also appear in uppercase letters. However, unless otherwise 
indicated, you can make all your entries without shifting to lowercase letters. 
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The format of a run control statement has these things in common: 





= The call is capitalized (e.g., CHG). 


m= A delta sign (A), when used, indicates a space is needed. 


m Fields or subfields enclosed in brackets are optional. In the following example, 
field2, subfield1, and subfield2 are optional: 


field1 [field2 subfield1,subfield2] 


Whenever you make an entry in an optional subfield, you must enter all intervening 
commas. For example: 


@AUX,2,6,2,999,cop,,,¥, 42 


ms =§=©>6- Braces around an item mean that you may choose from among the items listed. For 
example: 


Hoe or {item1 | jtem2} 
item2 : 





2.1.2. Run Function Format 


Every run function begins with the at sign (@) in the first column; however, within the 
run you can have @. comment lines, variables, or output data also starting in column 1. 
Table 2—1 alphabetically lists the run functions. 


Table 2-1. Run Functions 


(APPEND REPORT) 
(ADD REPORT) 
(AUXILIARY DEVICE) 
(BINARY FIND) 
(BREAK) 

(CHANGE) 

(COP DEVICE) 
(DELETE LINES) 
(DELETE REPORT) 
(DISPLAY REPORT) 
(DUPLICATE REPORT) 
(EXIT SUBROUTINE) 
(FIND) 

(BRANCH) 
(CONDITIONAL) 
(INDEX) 

(INSERT DATA) 
(LOCATE AND CHANGE) 
(LAST LINE NUMBER) 
(DUPLICATE LINE) 
(ADD LINE) 

(DELETE LINE) 


(UPDATE LOCK) 
(MATCH UPDATE) 
(MATCH) 

(PRINT) 

(READ CONTINUOUS) 
(READ LINE) 
(RELEASE) 
(REPLACE REPORT) 
(READ LINE NEXT) 
(RENAME) 

(RUN SUBROUTINE) 
(START RUN) 
(DISPLAY SCREEN FORMAT) 
(SORT) 

(SEARCH) 

(SEARCH UPDATE) 
(SUBTOTALLING) 
(TOTALIZE) 
(UNLOCK) 
(UPDATE) 

(WRITE LINE) 

(SIGN OFF) 








NOTE: 


These run functions are categorized and defined in Appendix A. 
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There is no single general format that can apply to all the run functions. The specific 
format of each run function is given in Section 5. However, all the run functions contain 
several or all the elements listed in this format example: 


@labet:function,mode,type,rid options characters parameters variables 


where: 
a 
Indicates that this is a run function. 
label: 
Is a number referenced by the @GTO (branch) run function to change the flow 
of control during execution of a run. Use decimal numbers within the range 1 
through 199. Label numbers must be unique within the run. 
Example: 
aIF V1 = V2 GTO 100;GTO 161 
210@:CHG V1 @ 
2101:CHG V1 V1 + 1 
function 
Specifies a run function and is three alphabetic characters long (except @IF). 
mode 
Indicates the decimal mode number (0 through 999). Specifies read only 
access or read and write access by an odd- or even-number configuration. 
type 
Is specified by the letters A through I. 
rid 
Indicates the identification number of the report (O through 999). 
options 


Alphabetic characters that indicate choices. If you don’t specify options, you 
must use a double apostrophe (’’). Enclose options that require special 
characters in apostrophes. Refer to Appendix B for the various options 
available and their descriptions. 
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Example: 
D Specifies option D. 
DH Specifies options D and H. : 
ase Specifies no options (two apostrophes). 
'D/! Specifies the D and slash options. 
characters 


Specifies column number in a line or field, number of characters, or an entire 
field. When specifying multiple fields, separate each with a comma. Define the 
character field in the following three formats: 


Fn Specifies the field of field number n. The n is a decimal number 
beginning with 1. 


Fn-l Specifies | characters from the first column field number n. The | is a 
decimal number beginning with 1. 


m-t Specifies | characters from column number m. The m is a decimal 
number beginning with 1: Unlike the other two formats, column 
numbers can be specified freely regardless of the field number. 


Examples: 
F4 Specifies the entire field of field number 4. 
F4~4 Specifies four characters from the first column of field number 4. 
F3,F6-6 First field: Entire field of field number 3. 
or field: Six characters from the first column of field number 
2-6 Six characters from the second column. 
2-6,9-10 First field: Six characters from the second column. 
Second field: 10 characters from the ninth column. 
parameters 


Defines the line type to be processed. It also defines the variables, constants, 
and expressions in relation to the character field that carry out the run function. 


Example: 


@SRH,500,B '' F4 *,CAT V1,V2 


@SRH Search run function is indicated for all RIDs in type B, mode 500. 
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*,CAT This is a parameter with an asterisk (*) line-type, searching for the 
three characters CAT in field 4 (F4). 


variables 
Describes the name of a variable, in this case V1 and V2, in which processing 
results and the operation results are entered. 
Example 1: 


Referencing one report in which you want to perform a range search: 


25:SRH,102,B,1 D F2 *,0/R,9 V4I5,V515 


where: 
a Indicates a run function. 
5: Is the label. 
SRH Specifies the particular run function. 
192 Is the mode (filing cabinet concept). 
B Is the type (drawer of the filing cabinet concept). 
1 Is the RID (specific report number in drawer concept). 
D Specifies the D option. See Appendix B. 
F2 Specifies the characters. 
*,0/R,9 Specifies the parameters. 


V415,V515 Specifies the variables. 
Example 2: 


Referencing two reports: 


06:MCH,102,B,1,1902,0,30 '' F3,F4 *,1,A F1,F3 *,1,A 
where: 
a Indicates a run function. 


6: Is the label. 
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MCH 
102,B,1 


102,D,30 


Example 3: 
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Specifies the particular run function. 

Specifies mode, type, and RID of the issuing report. 
Specifies mode, type, and RID of the receiving report. 
Specifies no options. 

Specifies characters of the issuing report. 

Specifies parameters of the issuing report. 

Specifies characters of the receiving report. 


Specifies parameters of the receiving report. 


Run function not referencing report: 


@8:CHG V1 V2 + V3 


V1 is the sum of variables V2 and V3. 


Example 4: 


Run function not referencing report: 


@RUN RUN2,V1,V2,SAM 


The current run executes run 2 and passes to run 2 data contained in variables 
V1 and V2 and the constant SAM. 


2.1.3. Variable Format 


Variables always begin with the letter V followed by a number from 1 to 199. They are 
work buffers. You can define the variable format type, number of columns, and initial 
value at the same time. Variables can be defined and redefined anywhere within the run. 


The format for variable definition is: 


:Vnnn type size [constant 


where: 


Vnnn 


Indicates variable definition. 


Describes the variable name (V1-V 199). 
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type Specifies the variable types (A,H,F,I,S). Refer to 2.1.2.1. 

size Indicates the number of columns. 

[(tab) Specifies the tab delimiter ([) between the variables and constants: 
constant Specifies constants or character strings as the initial value you want 


to store in the variable. 
Example: 


1V102H12[ 123456789012 Defines type H, number of columns (12), and the initial 
value of: (123456789012) of variable V102. 


2.1.3.1. Variable Types 
The following five types of variables are available: 
sw TypeA 


Maximum of 16 alphanumeric and special characters. You can perform arithmetic 
operations with type A variables via the @CHG run function. 


Example: 
:V1A1@[ABCDE12345 (Variable 1 with a size of 10 alphanumeric characters) 

= Type F 
Real numbers to a maximum of 16 characters, of which 14 may be the fractional 
portion. Use type F for arithmetic operations that contain fractional numbers. These 
variables must contain decimal points. Both sign and decimal point are significant 
digits; include them in variable size. Positive numbers do not require a sign; 
negative numbers require a minus (-—) sign. 


Examples: 


:V1F6.2(123.43 (Variable 1 is a positive number with a total size of 6 and 
two decimal positions.) 


:V2F7.2[£-123.43 (Variable 2 is a negative number.) 


m Type H 


Maximum of 16 alphanumeric and special characters. You cannot use type H for 
arithmetic operations. Use it to enter character strings. 
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Example: 


:V3H16[MAPPER8@.REPORTS (Variable 3 with a_ size of 16 alphanumeric 
characters) 


Type | 


Integers to a maximum of 16 characters. Use type | for arithmetic operations. The 
results are entered in an integer format. The sign is a significant character and must 
be included in the variable size. Positive numbers do not require a sign; however, 
negative numbers require a minus (-) sign. 


Example: 
1V5716[12345 (Variable 57 with a size of 6 specifying a positive 
number) 
:V5816[- 12345 (Variable 58 with a size of 6 specifying a negative 
number) 
Type S 


Alphanumeric and special characters with a maximum of 132 characters. Type S 
cannot be used for arithmetic operations. Use them to make character strings with 
a maximum of 132 characters. 


Example: 


:V152S3@[LABCDEFGHI JKLMNOPQRSTUVWXYZ1234 (Variable 152 with a size of 30 
characters) 


2.1.3.2. Methods to Initialize and Define Variables 


Three methods can be used for initializing and defining variables. These include the: 


Colon (:) 
Change (@CHG) run function 


Run function 


2.1.3.2.1. Using the Colon Method to Initialize and Define Variables 


Variables can be initialized by the colon method. To use the colon method, enter a 
colon in column 1 of the run, a variable name Vnnn tsss starting in column 2, a tab 
character ([), and the initial value of the variable. When defining multiple variables, 
delimit the variables with spaces and semicolons. 
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@ In the variable name Vnnn tsss, 


Vinnn Specifies V1 to V199. 


t Specifies the type (A,F,H,I,S). 

sss Specifies the number of characters. 
Example: 

:V1A3 [ABC 


:VIAS[ABC ;V2H3[DEF ;V313[123 ;V4F5.2[12.354 


2.1.3.2.2. Using the @CHG Method to Initialize and Define Variables 

To use the change method, enter an @CHG run function, followed by one or more 
spaces. Next, define the variable, followed by one or more spaces. Then, define the 
value of the variable. You can include multiple @CHG run functions on the same line. 


Example: 


@CHG V1A3 ABC 
@ @CHG V213 123 CHG V3F5.2 12.34 


2.1.3.2.3. Using the Run Function Methods to Initialize and Define Variables 
Several run functions initialize variables: (@RDC, @RDL, and @RLN). The @FND run 


function places certain information into variables, and the @TOT run function puts 
values into variables. 


Example: 


@RDL,2,B,6,8 F1,F2 V10A2,V11A6 


Reads in the first two characters from the first field (F1) of line 8 of the report (2, 
B, 6). Reads in six characters from the second field (F2) and enters them in the 
type A variables V10 and V11. 


2.1.3.3. Variable Initialization and Manipulation Techniques 


Entering blanks in the variables involves enclosing one blank character in apostrophes or 
writing blank characters equal to the size of the variable. 


UP-9734 


Example: 


:VIA4CT IA! 
V1A4 [AAAA 
@CHG V1A4 ‘A! 
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It is also possible to reference and process parts of character strings in a variable. 


Example: 


Vn¢m-l) 


Vn is the variable name between V1 and V199; m is the position of the character 
in the variable (1 through 132); | is the number of characters (1 through 132). 


The variables m and | can be of the A or | type. 


The value of the variable must be from 1 through 132. 


Example: 
:V1H6LYYMMDD 
@CHG V2H2 V1(3-2) 
QCHG V311 3 CHG V411 2 


CHG V5H2 V1(V3-V4) 


MM (month) enters V2. 
V3 assigned a value of 3, and V4 assigned a value of 2 


MM enters V5. 


It is also possible to modify and initialize variables. This is accomplished by using the 
@CHG run function and @INS run function. 


Example: 
@CHG V10A3 AAA 
@CHG V19 BBB 
@CHG V1113 123 
@CHG V11 V11+1 
°7V12S15£0123456789ABCDE 
@INS V10 V12¢1-3) 
@INS V11(2-2) V12(14-2) 
QCHG V1314 4 


@CHG V1 V12 (V13-3) 


Defines V10 contents as AAA. 

Defines V10 contents as BBB. 

Defines contents of V11 as 123. 

The contents of V11 becomes 123 + 1 = 124. 
Defines contents of V12 (initial value). 

The contents of V12 becomes BBB3456789ABCDE. 
The contents of V12 becomes BBB3456789ABC24. 
Defines contents of V13 as 4. 


Contents of V10 becomes 345. 
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2.1.4. Data (Output Line) Format 

When the first column of the run function starts with a character other than @ or ;, it is 
considered an output line. These lines are written sequentially in the output area. Refer 
also to 3.6. Variables described in the output line are written to the output area after 
being replaced by substitute values. 

Example: 


:V1A5 [LABCDE;V215[12345 Defined variable line 


OUTPUT DATA V1,V2 Output line 


OUTPUT DATA ABCDE, 12345 Data is substituted into variables V1 and V2 and then 
written to the output area. 


2.1.5. Comment Format 
Comments may be entered freely in the run. Comments are useful for describing the 


input to the run, the logic flow of the run, and the output from the run. Comments may 
include any data that the user feels is pertinent. 


Comments do not appear in the results produced by the run, nor do they affect the 
processing performed by the run. There are two comment formats: comment lines and 
commenting after a run function. 

2.1.5.1. Comment Lines 

When a period immediately follows an @, that line is considered a comment line. 


Example: 


a. THIS IS A COMMENT LINE 


When a period immediately follows a label, that line is considered a comment line. This 
type of line may be the destination line of an @GTO run function. 


Example: 
aGTO 50. THIS IS A COMMENT LINE 
050. THIS IS A COMMENT LINE 


Shows branching to the label 50 line. 
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2.1.5.2. Commenting after a Run Function 


To enter comments on a run function line, terminate the run statement with the 
character string space period space (A.A). 


Example: 


@CHG V1A6 DATE1$ . INITIALIZE V1 with DATE 


2.2. FIELDS AND SUBFIELDS 


Run function statements consist of fields and subfields. Fields are delimited by spaces. 
Each field can also be delimited into subfields with commas, slashes (/), and hyphens. 


Example: 


@5:SRH,102,B,1 







Field Number 








Subfield 1 [(Tab) V415 
2 A192 V516 
3 R 
4 B200 


2.3. RESERVED WORDS 


Reserved words end with a dollar sign ($) and contain specific data. For example, the 
reserved word TIME$ contains the current time in the format HH:MM:SS. Only MAPPER 
80 software can initialize the reserved words. Access to the reserved words is limited 
to the @CHG run function. The user can initialize a variable with the value of the 
reserved word by the @CHG function. The initialized variable can then be used by other 
run functions. 


Examples: 
@CHG V1A8 TIMES Enter time in the variable. 
TIME=V1 Writes time in output area. 
NOTE: 


When creating MAPPER 80 runs, character strings ending in a dollar sign ($) should be 
enclosed in apostrophes. This prevents character strings from being mistaken for 
reserved words. 

Example: 


"STOPS! 
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The reserved words used by the MAPPER 80 system are listed in Table 2-2. 


Table 2—2. MAPPER 80 Reserved Words 


CHARS$ Specifies the maximum number of characters per line for the current result. 


DATE1$ 












Specifies the current date. The format is yymmdd, where: 








yy is the year; 
mm is the month; and 
dd is the day. 


DEPN$ Specifies the department number of the user when signing on. 
DLINES Specifies the line number of the first line displayed. 


FMT$ 










Specifies the format number of the displayed report. 












INPUTS Specifies external data input to the run. The maximum number of variables is 40 with 


a total of 320 characters. 





LINES 





Specifies line number to be read with the next @RLN run function. 


LLPS Specifies the number of run functions that are processed. 








MODES$ Specifies mode number of the current result. 


MODE 1$ Specifies the new mode number of the mode referenced from the workstation 
executing the run. 
OLINE$ Specifies the line number after the line currently being written in the output area. 


Specifies status 1 of the special function. This includes status or number. Initialize 
STAT1 : ; 
with | type variable. 


Specifies status 2 of the special function. This includes status or number. Initialize 
STAT2 P : 
with | type variable. 


STNUMS$ Specifies the workstation identity requesting run functions. 


TIMES 























Specifies the current time. The format is hh:mm:ss, where: 





hh is hours; 
mm is minutes; and 
ss is seconds. 





TYPES Specifies the type of the current result. 


Specifies the user identifier {identifier used when signing on). 


2.4. GUIDELINES FOR CONFIGURING THE RUN FUNCTION 
Consider the following guidelines when configuring the run function: 


1. Define multiple run functions on the same line by placing one or more blanks 
between each run function. 
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2: 


The semicolon can fulfill two roles: 
a When defining two or more variables, use a semicolon between each variable. 
Example: 


:ViAZ [ABC ;V214[1234 


= =When you use the @IF run function, a semicolon delimits multiple conditions 
selected in the same line. 


Example: 


@IF V1 = 3 GTO 9;IF V1 < 6 GTO 8;IF V1 = 6 GTO 10 
@GTO END 


If the value V1 is equal to 3, go to label 9. 

If the value of V1 is not equal to 3 and is less than 6, go to label 8. 

If the value of V1 is equal to 6, go to label 10. 

If the value of V1 is greater than 6, the next run function is executed (in 
this example, the run ends). 


When describing special characters with run functions and variables for purposes 
other than delimiting characters (constants or character strings), enter the character 
within apostrophes. 


Example: 


@CHG V1 V2 '/' V3 
MSRH,100,B,2 DH F1-1 [,'a@' V1I3,V215 


When you use a space character for reasons other than delimiting the field, enclose 
it in apostrophes. 


You do not have to use subfields at the end of a field. Omit subfields by adding a 
series of commas. Fields must not end with a comma. 


Example: 
1,2,35,4 No omissions 
72,3,4 First subfield omitted 
1,2,,4 Third subfield omitted 
1,2,3 Last subfield omitted 


Subfields can be defined with variables. 
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Example: 


:V1130102;V2A1[B;V31301 
= V6H4[A100;V7H4[B200 
@5:SRH,V1,V2,V3 D F1-4 [,V6/R,V7 V4I5,V516 


This is the same as: 


@5:SRH,102,B,1 D F1-4 [,A102/R,B200 V415,V516 


Although multiple run functions can usually be combined in one statement, run 
functions must not be defined after the following functions: @DSP, @ESR, @RDC, 
@RSR, @RUN, and @SUB. 


The label must be from 1 through 199. 
The variable name must be from V1 through V199. 


When executing the @WRL, @LN+, @LN-, and @LNX run functions, you must lock 
the report being updated with the @LOK run function. 


An output line must follow the @SUB and @RDC run functions. You can specify 
only one line for output. 


Example: 


@RDC,102,C,1,30,100,(,40 F1,F2,F3 V1A9,V2A5,V316 
V1 V2 V3 


From the report in mode 102, type C, RID 1, starting at line 30 for 100 lines, read 
the contents of fields F1, F2, and F3 into variables V1, V2, and V3, respectively. 
Then write V1, V2, and V3 to the output area. Product name equals V1, 
classification equals V2, cost equals V3. 


Example: 


@SUB,102,C,1 E F2,F3,F8 (,S,+,+ V1I3,V2A5,V318,V414 
V1 V2 V3 V4 


Accumulate subtotals for fields F3 and F8 into variables V3 and V4 for each 
change in field F2 (subkey). Include the number of entries into V1 for each change 
in field F2 (subkey). Then write V1, V2, V3, and V4 to the output area. Total, 
classification equals V2, number of entries equals V1, cost equals V3, and quantity 
equals V4. 


lf a number follows the letter V, it is considered a variable name. If you follow the 
letter V with a number that is a constant or character string, you must enclose it in 
apostrophes. 
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Example: 





@CHG V1I3 123 
THE VALUE OF 'V1' is V1 


Variable V1 is initialized to 123. The next line is written to the output area. The 
value was substituted for the variable to produce the following line: 


THE VALUE OF V1 IS 123. 

13. The back slash (\) is used when a run statement is carried over to the next line. 
The @ sign is not specified on the continuation lines. Up to nine continuation lines 
may be used. The maximum number of characters in a single run command is 256. 
Specify line continuation in the following ways: 
= After a field: space back slash (A\) 

a After a subfield: back slash (\) 


Examples: 


@10:MCH,102,B,2,192,D,1 '' F1,F4,F11 [,1,A,BA\ 
F1,F3,F8 [,1A,B 





@20:WRL, 102,B,2,102 F1,F2,F3,F4 £,V1,V2,V3,V4/0,V114,\ 
V12,V13,V14/L,V21,V22,V23,V24 


14. All required fields, within each instruction must be defined. 
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3. Processing Reports 
and Results 


3.1. GENERAL 


The run functions, as compared to the manual functions, require closer attention when 
processing reports and results. This section describes the data types processed by run 
functions, including the results. 


3.2. DATA TYPES 


When you use manual functions, such as TOT and SORT, results are created. If you use 
this result in the execution of the next manual function, a new result is created and the 
result prior to the execution is lost. Run functions, on the contrary, allow you to save 
the result prior to the execution. 


The four types of data that the MAPPER 80 run functions process are shown in Figure 
3-1. 


3.3. PROCESSING REGULAR REPORTS 


You can process regular reports in the MAPPER 80 data base by specifying the mode, 
type, and report number (RID) of the report in the run function. Usually, only reports in 
one mode are accessible. However, with the approval of the MAPPER 80 coordinator, 
you can access reports in other modes. 


3.4. PROCESSING RESULTS 


You can use results generated by manual functions as input to a run. These manual 
functions can include TOT and SORT. 


Results produced by the execution of a run function are temporarily stored in the current 
mode and type under a RID number of —O. If another run function that produces a result 
is executed, the previous —O result is replaced with this result. Only one result at a time 
exists under the RID number —O. To save a —O result for further processing at a later 
point in the run, you must rename it by using the RNM run function and then access the 
result under a RID number of —1 to —4. 





UP-9734 SPERRY OS/3 3-2 
MAPPER 80 RUN FUNCTIONS 





REPORT 
INPUT 


RESULT 
INPUT 


@DSP 
@GTO END 


WORKSTATION RESULT 
INPUT /OUTPUT 
oy we 


OUTPUT 
AREA 


@BRK 
@GTO END 


RESULT 
INPUT /OUTPUT 
-0 


REPORT 
OUTPUT 





Data Types: 
q) Regular data in the MAPPER 80 data base 
Q) Results generated by the manual functions that are input to the run 
@) Results (—1 to —4) temporarily saved using the @RNM run function from the result (—O) created by the run (3.4.1) 
@) Result (—O) created by the @BRK run function are temporarily stored in the current mode, type, and RID (—0). Refer 


to 3.5.1. 


Figure 3-1. Data Types Handled by Run Functions 
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3.4.1. Using the @RNM Run Function to Process Reports 


Only one result exists at any time when processing the report with the manual or run 
functions of MAPPER 80 software. When it is necessary to save a certain number of 
results during run execution, you can temporarily save these results by using the 
@RNM run function. This command saves the current result -O by changing the result 
number to a number between —1 and —4. The maximum number of results that you can 
save using the @RNM function is four (-1 to —4). You access these renamed results by 
specifying the result number (—O to —4) as the RID number. For example, to display the 
-—3 result from mode 102, type B, you issue the following command: 


aDSP,102,B,-3 


Examples: 


1. @SRH,M,T, 


@RNM -4 


2. @SRH,M,T, 


@RNM -3 


3. @SRH,M,T, 


@RNM -2 


4. @SRH,M,T, 


@RNM -1 


5. @SRH,M,T, 


R''F4 
R')F4 
R''F4 
R''F4 
R''F4 


,AV1,V2 


,BV1,V2 


,C V1,V2 


,D V1,V2 


rE V1,V2 


Search for item A in field 1 of mode (m), type (T), and RID (R) 
and save the result as result number —4. 


Search for item B in field 1 of mode (M), type (T), and RID (R) 
and save the result as result number —3. 


Search for item C in field 1 of mode (M), type (T), and RID (R) 
and save the result as result number —2. 


Search for item D in field 1 of mode (M), type (T), and RID (R) 
and save the result as result number —1. 


Search for item E in field 1 of mode (M), type (T), and RID 
({R). (Result automatically saved as —O) 


The following five reports are created as a result of these five examples: 


-4 -3 23 -1 -O 
ITEM ITEM ITEM ITEM ITEM 
A, B, C; D, .E, 


The results created by the searches can be printed on the auxiliary printer with the 


following types of run function statements. 


@AUX,M,T,-4 
@AUX,M,T,-3 
@AUX,M,T,-2 
@AUX,M,T,-1 
@AUX,M,T,-@ 
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3.5. OUTPUT AREA 


An output area is the temporary work area used by MAPPER 80 software to store data 
prior to creating results. 


All lines in a run report starting with characters other than @ or : are called output lines 
and are written sequentially in the output area. (See Figure 3-2.) 


RUN CONTROL STATEMENT OUTPUT AREA 


@S RH 
ABCD 
EFGH 
V 313 
1234 
5678 


@TOT 





JKLM 


@GTO END 


Figure 3-2. Output Area Containing Output Lines 


3.5.1. Using the @BRK Run Function with the Run Output Area 


When the @BRK run function executes, the contents of the run output area up to that 
time becomes result (—O). The contents of the output area is then cleared and 
subsequent output lines are written to the cleared output area starting at line 2. 
MAPPER 80 software uses the first line to set the date. 


The run report’s mode and type numbers are automatically assigned to the output area 
when starting the run but can be changed by including a new mode and type in the 
@BRK run function. The new mode and type are assigned to subsequent results created 
by the @BRK run function, but not to the current result. See 5.1.5 for more information. 


3.5.2. Using the @GTO END Run Function with the Run Output Area 


When the @GTO END function executes, the run ends, the contents of the output area 
become the result, and the result is displayed on the screen. Manual functions can be 
used to further manipulate the displayed results. See 5.1.14 for more information. 
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4. Workstation Operation 


4.1. GENERAL 


This section describes the operation of the MAPPER 80 workstation when using the run 
functions. 


4.2. STARTING THE RUN 


You can start the run by using any of the access methods found in the subsequent 
subsections. 


4.2.1. Formal Access Method 


The run function name is input after the start of entry (SOE) character of line O or as the 
function name in the home position when a report is displayed. It may also be input as: 


m the function name field of the user logo; or 


m= the function name in the exchange function name field of the function request 
screen. 



































KKKKKKKKKKKKKKKKKKKEKKKKKKEKKKK 


x 

kx MAPPER 80 ( 2.00 ) * 
k x 
x USER (C JDOE ] * 
x D-NO. C€ 007 J * 
* MODE [ 102 J x 
* WORK STATION { TOl 1 x 
* 83 / 07 / 07 x 
FRR I KIKI IIR KI IK IARI II IK RIK II 


C ENTER FUNCTION REQUEST ] 


FUNCTION ( run_ ) 
PARAMETER < > 
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KKKKKKKKKKKKKKKKKKKEKKKEKEKKEKK 


x FUNCTIONC RUN Jj * 
KAKI KI IKK IK IK IIIA II KIKI IKI IK 


{ ENTER REQUESTED INFORMATION } 
RUN NAME ( ) : ALPHABETIC, NUMERIC 
PARAMETER < > 


{ ENTER NEW FUNCTION REQUEST J 
FUNCTION < > 


PARAMETER < > 





7. The run name field contains the run name of the run to be entered. 


2. The parameter field contains the input parameter to be passed to the run. This is 
optional. The parameter consists of a single, nondelimited character string with a & 
maximum length of 32 characters. 





3. Run execution begins after all fields are filled in and transmitted. When you start 
the run with the fast access methods, the maximum length, including the run name, 
is 30 characters. 


The parameter, which is entered into the reserved word INPUT$, can be divided into 
segments by the @CHG run function contained in the called run. 


@CHG INPUTS V1I3,V2A1,V313 


In the following examples of the fast access method, parameter 102BO02 is passed to 
the run, JOOERUN 1. 


The @CHG run function in JDOERUN1 transfers data from INPUT$ to the variables 
based on the defined length of the variables. The length of V1 is 3, V2 is 1, and V3 is 
3. 


The first three characters of INPUT$ are entered into V1, the fourth character is entered 
into V2, and the last three characters are entered into V3. 


The contents of the variables at the completion of the @CHG run function is: 





V1=102 
V2=B 
V3=002 
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The variables can now be used by other run functions, such as: 
aDSP,V1,V2,V3 


4.2.2. Fast Access Method 1 


With fast access method 1, the input begins after the SOE of line 0, at the home 
position, or in either the function exchange field of the function request screen or in the 
function field of the user logo. The format is: 


> RUN run-name, [parameter] 


Example of input from line O: 

































































LINE> run jdoerunl,102b002  SHFT> HLD CHR> HLD LN> PSWD> > 
-DATE 83/07/05 10:47:50 TYPE=B RID=002 83/06/29 JDOE < 48 LINES> 
. << CORPORATE PRODUCTION STATUS >>> : 

*ST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
ha DATE .IN. TYPE .NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 


SD | SSRResS SS SSS STS SSS SSS SSS SS SSSH LL SSSSS SSSR SHSSSS SSS SSs Hse Sss sess ,set = 





P 741224 LS BLACKBOX1 436767. "84389 AMCO 741223 741224. 
IP 741225 LS BLACKBOX1 436768 84390 AMCO 741223 741225 
IP 741219 LS BLACKBOX2 637071 84353 INTR 741218 741219 





iI 






































—————— 
= SS ee 


























KKKKKKKKKKEKEKKEKEKER KEKE EK 


* FUNCTIONCE TOT J * 
KIKI IKI KIKI KIA III IKI RIKI RIK 


{( ENTER REQUESTED INFORMATION J 


REPORT NO. ( ) : 'O' - '999' OR '-' 


TYPE < > : ‘At - 'I' (WHEN REPORT NO. IS '-', YOU 
CAN OMIT TYPE) 
FORMAT < > : 'l' - ‘6! 


C ENTER NEW FUNCTION REQUEST ) 
FUNCTION < run_ > 
PARAMETER < jJdoerunl ,102b002 > 











- UP-9734 SPERRY OS/3 4-4 
MAPPER 80 RUN FUNCTIONS 





Example of input from the user logo screen: 


























FRI I IK IK II IIR IKI IIR II IK TR II 
x MAPPER 80 (2.00) * 
x * 
x USER [ JDOE } * 
x D-NO. C 007 J x 
k MODE (C 102 ] * 
x WORK STATION (C TO1 ] * 
x * 
* * 


83 / 07 / 13 
KIKI II KIKI KI IIR IRR IIR IORI IK 


{ ENTER FUNCTION REQUEST 1] 


FUNCTION ( run_ } 
PARAMETER < jdoerunl ,102b002 > 





Run execution starts when you press the transmit key. 


4.2.3. Fast Access Method 2 


With fast access method 2, enter input after the at sign (@) is placed in front of the run 
name. Key in the run function after the SOE of line O or the home position. The format 


appears as: & 


> @run-name, [parameter] 





























LINE> @jdoerunl ,102b002 SHFT> HLD CHR> HLD LN> PSWD> > 
-DATE 83/07/05 10:47:50 TYPE=B RID=062 83/06/29 JDOE < 48 LINES> 
. <<< CORPORATE PRODUCTION STATUS >>> 

*ST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
*xCD. DATE .IN. TYPE -NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 
k= Ss2e5= == Ssessszrseaz s=Ssasss= Srsors=s5 sss sss =sssrs= > SSSsst  , SSSee5 ,S5S55,5= 


IP 741224 LS BLACKBOX1 436767. 84389 AMCO 741223 741224 
IP 741225 LS BLACKBOX] 436768 84390 AMCO 741223 741225 
IP 741219 LS BLACKBOX2 637071 84353 INTR 741218 741219 





Run execution starts when you press the transmit key. 
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4.3. RUN EXECUTION/TERMINATION VIA WORKSTATION 


4.3.1. Workstation Display during Run Execution 


When run execution starts, the run logo message appears on the first line of the 
workstation display. The rest of the lines on the screen remain in the state they were in 
prior to the start of the run. These lines remain on the screen until they are replaced by 
another display (report or result display, error message, user logo, etc) that is related to 
the execution of the run. 



































MAPPER80 RUN FUNCTION PROCESSING <F4...CANCEL> 


KKKKKKKKKKKKEKKKKKKKKKEKEKKKKEKK 


x* FUNCTIONC RUN J] * 
KI KIKI K IIA IKI III ERIK IK 


{ ENTER REQUESTED INFORMATION J 
RUN NAME (| jdoerunl ) : ALPHABETIC, NUMERIC 
PARAMETER < 102b002 > 


me ee a a a a a a a a a a a a a a ee ee ere eee 


{ ENTER NEW FUNCTION REQUEST 1] 
FUNCTION < > 


PARAMETER <_ r—“—™SOSC—C‘(D 





4.3.2. Workstation Termination 


You can terminate the run, but only when the run logo is displayed, by pressing 
function key F4. The following message appears on the bottom line of the screen. If 
you enter a Y response, the run terminates. 


























DO YOU WISH TO CANCEL THIS RUN ? YORN( —) 





UP-9734 


SPERRY OS/3 
MAPPER 80 RUN FUNCTIONS 


4.4. INPUT, DISPLAY, SCREEN FORMAT SERVICES 


4.4.1. Display and Input Using @DSP Run Function 





4-6 


When the @DSP run function executes, the specified report or result appears on the 
workstation screen. 





LINE> 1 FMT> RL> 


DATE 83/07/05 
2 6k« 
xST. 
xCD. 


NOTE: 


STATUS. BY. PRODUCT 
DATE .IN. TYPE 


741224 LS BLACKBOX1 
741225 LS BLACKBOX1 
741219 LS BLACKBOX2 
750110 LS BLACKBOX4 
750110 LS BLACKBOXS 
741222 LS BLACKBOXS 
741203 LS BLACKBOX0 


SHFT > 
10:47:50 TYPE=B RID=002 
CORPORATE PRODUCTION STATUS >>> 

. SERIAL. PRODUC .ORDER. 
‘ -NUMBER. COST .NUMBR. 


436767 
436768 
637071 


675281 
737582 
746327 


HLD 


CHR> HLD LN> PSWD> > 
83/06/29 JDOE < 48 LINES> 
CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
CODE. PLAN .ACTUAL. DATE .ORDER.COD. 
AMCO 741223 741224 

AMCO 741223 741225 

INTR 741218 7412193 

ARCO 

FEDS 750131 

AMCO 741222 741222 

FEDS 741201 741202 741203 S8738 


In this example, @DSP, 102,B,2,,,, N is executed. 


When you specify the wait input after display {,,,,N) parameter, you can manipulate the 
displayed report or result with the following manual functions: 


1. Line O functions: 


LINE> FMT> RLD> SHFTD 


2. L, LL, CC, and FLD functions 


3. Line update functions: 


Update line 
Add line 
Delete line 


Duplicate line 


4. Run ending functions: 


HLD CHR> HLD LND> 


Release function (A) — Run ends and the user logo is displayed. 


Sign-off function (X) — Run ends and the idle logo is displayed. 
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When you input RSM after the start of entry (SOE) of line O or at the home position, or 
you press the function key F1, the run restarts execution at the next run function. 


























aa 
ST. 
*xCD. 


LINE> rsm 
-DATE 83/07/05 


STATUS. 


DATE 


741224 


741225 
741219 
750110 
750110 
741222 
741203 


FMT> RL> 


BY. 
.IN. 


PRODUCT 
TYPE 


" BLACKBOX1 


BLACKBOX1 
BLACKBOX2 
BLACKBOX4 
BLACKBOX5 
BLACKBOX5 
BLACKBOX0 


SHFT > HLD 


10:47:50 TYPE=B RID=002 
CORPORATE PRODUCTION STATUS >>> 

. SERIAL. PRODUC. ORDER. 
.NUMBER. COST .NUMBR. 


"436767. 84389 


436768 84390 
637071 84353 

94754 
675281 $7441 
737582 84040 


746327 54237 


CHR> HLD LN> PSWD> > 
83/06/29 JDOE < 48 LINES> 


CUST .PRODUC. 
.ACTUAL. DATE .ORDER.COD. 


CODE. PLAN 


“AMCO 741223. 


AMCO 741223 
INTR 741218 
ARCO 

FEDS 750131 
AMCO 741222 
FEDS 741201 


PRODUC. SHIP .SHIP .SPC. 


741224 
741225 
741219 


741222 
741202 741203 $8738 





When run execution restarts, the run logo is displayed on the first line of the screen. 




















a 


=> 




















—— 









*CD. 


«KK 
*ST.STATUS.BY. PRODUCT 


DATE 


DATE 83/07/05 


IN. 


MAPPER80 RUN FUNCTION PROCESSING <F4.. 


TYPE 


436767 84389 AMCO 741223 741224 
436768 84390 AMCO 741223 741225 
637071 84353 INTR 741218 741219 


. CANCEL> 

10:47:50 TYPE=B RID=002 83/06/29 JDOE < 48 LINES> 
CORPORATE PRODUCTION STATUS >>> 
. SERIAL. PRODUC .ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
.-NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 
kez, SSPSSS SS SSeS Sssss  SSSSSs SS SSSS LSS SSS, SSS LSS SSS SSS SSS SSS SSS SSeS ss see, 
IP 741224 LS BLACKBOX1 
IP 741225 LS BLACKBOX] 
IP 741219 LS BLACKBOX2 





ii 


When there is no wait input after display (,,,,Y) parameter for the @DSP run function, 
one screen of the report or result specified is displayed. The run then continues 
execution with the next run statement and the run logo reappears on the first line of the 


screen. 





























ST. 





NOTE: 


In this example, @DSP,102,B,2,,,,Y is executed. 


KKK 


ee 


STATUS. 


DATE 


741224 
741225 
741219 
750110 
750110 
741222 
741203 


.DATE 83/07/05 


BY. 
-IN. 


MAPPER80 RUN FUNCTION PROCESSING <F4.. 


PRODUCT 
TYPE 


BLACKBOX1 
BLACKBOX1 
BLACKBOX2 
BLACKBOX4 
BLACKBOX5 
BLACKBOX5S 
BLACKBOX0 


10:47:50 TYPE=B RID=002 
CORPORATE PRODUCTION STATUS >>> 

. SERIAL. PRODUC. ORDER. 
-NUMBER. COST .NUMBR. 


"436767 84389 
436768 84390 
637071 84353 


675281 97441 
737582 84040 
746327 54237 


CUST. PRODUC. 
CODE. PLAN 


AMCO 741223 
AMCO 741223 
INTR 741218 


FEDS 750131 
AMCO 741222 
FEDS 741201 


. CANCEL > 
83/06/29 JDOE < 48 LINES> 


.ACTUAL. DATE .ORDER.COD. 


PRODUC. SHIP .SHIP .SPC. 


"741224 
741225 
741219 


741222 
741202 741203 38738 
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4.4.2. Display and Input Using the @SFS Run Function 


When the @SFS run function executes, the specified screen format services screen will 
be displayed at the workstation. The output data specified with the @SFS run function 
is displayed in the output fields and the bidirectional (input/output) fields of the screen. 


If the specified screen format services screen has input fields or input/output fields, it 
waits for data input. Key in the data and transmit. The transmitted data enters the 
variables specified by the @SFS run function. The run restarts at the next run function 
and the run logo appears. 


When there are no input fields and no input/output fields, the screen format services 
screen appears, then the run continues execution at the next run function. The run logo 
appears with the screen format services screen. 


4.5. RUN END DISPLAY 


4.5.1. Using the @GTO END Run Function 


The run ends when the @GTO END run function executes, and the output area appears 
on the screen as the result. The display format is the same as that of a regular result. 


Example: 
@BRK,102,B 
RUN TEST START 
RUN TEST END 
@GTO END 


When these statements execute, the following information appears on the screen. 























LINE> 1 FMT> RL» SHFT> HLD CHR> HLD LN> PSWD> ''RESULT''> 
DATE 83/07/13 14:38:15 TYPE=C  RID= 83/06/29 JDOE < 4 LINES> 
RUN TEST START 








tia 


If the mode number of the displayed result is the same as the mode number assigned 
when the user signed on, or the same as the mode number selected with the mode (M) 
manual function before execution of the run, regular manual functions can be executed 
for this result. 


When the mode number of the displayed result differs, you can use only limited manual 
functions. 


If the following statements are executed when the mode at the time of sign-on is 102, 
the mode of the displayed result will be 110. 
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Example: 
@BRK,110,B 
RUN TEST START 


RUN TEST END 
aGTO END 


4.5.2. Using the @REL Run Function to End a Run 

When the @REL run function executes, the run ends. The user logo appears on the 
screen at this time. 

4.5.3. Using the @XIT Run Function to End a Run 

When @XIT run function executes, the run ends. The idle logo appears on the screen at 
this time. 

4.5.4. Error End of Run 

When an error occurs during run execution, the run ends. 

If the run ends in error, the run report appears on the screen. At the same time, an 
error message appears on the bottom line of the screen. Information indicating the error 


position (line number) and column number in the run report) also appears as a hold line 
on the second line of the screen. 



































LINE> 10 FMT> RL> SHFT > HLD CHR> HLD LN> 1 PSWD> > 
. *k*k ERROR OCCURED AT 6 COLUMN IN THE FOLLOWING LINE ( 10 ) 298/B/016 xx 
@CHG V101 TIMES 

@SFS U100 V100,V101 

@SOR,102,2,B '' Fl ,1 

@GTO END 


<ERR 960>(CAN'T REFER TO UNDEFINED VARIABLE) 
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If the mode number of the run report is the same as the user’s mode number, you can 
immediately correct the error portion of the run report and reexecute the same run. 





When the mode number of the run report differs from the user's mode number, 
corrections are not possible and you can use only the PR, AUX, and COP manual 
functions. 











UP-9734 SPERRY OS/3 5-1 
MAPPER 80 RUN FUNCTIONS 


5. MAPPER 80 Run 
Function Commands 


5.1. GENERAL 

This section alphabetically lists the run functions. A description of each run function, its 
format, and examples are provided in this section. Optional parameters are enclosed by 
brackets. 

These run functions can be entered in uppercase or lowercase letters; however, the 
MAPPER 80 software stores and outputs data in uppercase only. 


5.1.1. @ADD (Append Report) Run Function 


The @ADD run function appends a specified report (added report) to another report (the 
base report), creating a result. 


The mode and type of the result are the same as the mode and type of the base report. 
To save the result, use the @RNM, @REP, or @DUP run functions. 

NOTE: 

The line length of the base and added reports must be the same. 

Format: 


@ADD,mode1, type1,rid1,mode2,type2,rid2 


where: 


mode1 
Specifies the mode of the added report. 


type1 
Specifies the type (A-—l) of the added report. 


rid1 
Specifies the RID of the added report. 
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mode2 
Specifies the mode of the base report. 


type2 
Specifies the type (A-—l) of the base report. 


rid2 
Specifies the RID of the base report. 


Example: 


@ADD,2,B,2,102,B,1 


Add 2,B,2 to 102,B,1 to create a new result. 


QDUP, 102,B,-0 


Duplicate the result to the first available RID. The reserved word STAT1 contains 
the RID number of the duplicated result. 
5.1.2. @ADR (Add Report) Run Function 
The @ADR run function creates a new report in the mode, type, and RID number 
specified. When you don’t specify a RID number, the new report is created with the 
next available report identification number. The new report’s RID number is set in the 
reserved word STAT1. 


Format: 


aADR,mode, type[,rid] 


where: 


mode 
Specifies the mode of the new report. 


type 
Specifies the type (A-l) of the new report. 


rid 
Specifies the report number (RID) of the new report. 


Example 1: 
Case where the report identification number (RID) is omitted: 


QADR, 102,B 
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New report created in mode 102 and type B. 


@CHG V1I3 STAT1 


Variable 1 acquires the RID number of the new report from STAT1 reserved word. 
Example 2: 
Case where the report identification number (RID) is specified: 


MADR, 102,B,20 


Creates a new report in mode 102, type B, and RID 20. 


5.1.3. @AUX (Auxiliary Device) Run Function 


The @AUX run function prints the specified report on any printer connected to a 
workstation that is linked to the same MAPPER 80 job. 


Format: 


AUX ,mode, type, rid, [station],, [sequence], [format],,[delete-header], 
(first-column], [spacing], ({start-column] 


where: 


mode 
Identifies the mode of the report to be printed. 


type 

Identifies the report type (A-l) to be printed. 
rid 

Identifies the report identification number to be printed. 
station 


Names the auxiliary equipment where the reports are to be printed. The format 
is Pxx. 


If omitted, the report is printed on the auxiliary device connected to the workstation 
that started the run. 


sequence 
When a Y is specified, the line numbers are not printed. 


If omitted, the line numbers are printed. 
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format 
Specifies the format number (O—6) used when printing. 


If omitted, the basic format number O is used. 


delete-header 
When Y is specified, the header lines of the report are deleted. 


If omitted, the header lines are printed. 

first-column 
When Y is specified, the character in the first column of each line is not 
printed. 


If omitted, printing starts with the first column. 


spacing 
Specifies the spacing requirements (1-9). 


If omitted, the report is single-spaced. 


start-column 
Specifies the first column number to be printed (1-132). 


If omitted, the default value is 1. When both the start-column and first-column 
parameters are specified, the first-column parameter is ignored. 


Example: 


@AUX, 102,B,2,P01,,Y,1,,,%,2 


Prints mode 102, type B, and RID number 2 report on the PO1 printer, deletes line 
number, uses format 1, deletes the first character of each report line, and double 
spaces. 


5.1.4. @BFN (Binary Find) Run Function 

The @BFN run function searches the report for the specified item by the binary division 
method and enters in a variable the line number containing that item. The field 
containing the item must be presorted in ascending order. The values of two variables 
are set as a direct result of this run function. They are: 


variable 1 Specifies the RID number of the found item. 


variable2 Specifies the line number of the found item. 
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& When the search item cannot be found, or if the specified field has not been sorted, 
control transfers to the specified label. An error status appears in the reserved word 
STAT1. The following values are set in the contents of the reserved word STAT 1: 


Value Meaning 


1 Specified item cannot be found. 

2 Indicates that all lines are blank, when @ option is specified. 

3 Indicates that data is not sorted. 

4 Specified report does not have an index. See message ERR 719 for 


corrective action. 
Format: 


@BFN,mode, type,rid,({start-line],[tabel] options characters [line-typel, 
parameters [variable1],variable2 


where: 


mode 
& Specifies the mode of the report to be searched. 


type 
Specifies the type (A-l) of the report to be searched. 


rid 
Specifies the RID number of the report to be searched. 


start-line 
Specifies the line number on which searching is to start. 


If omitted, searching starts on the first line. 


Label 
Specifies the destination label if an error occurs. 


lf omitted, the next run function is executed. 


options 
Specifies options. Refer to Appendix B. 


characters 
Specifies the field, partial field, or character positions to scan. 


& Line-type 


Specifies the line type (tab type only) to scan. 


If omitted, tab type lines are assumed. 
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parameters 
Specifies data (parameter) to be found. 





variable 
Specifies the variable to hold the RID number. 


var iable2 
Specifies the variable to hold the line number where the item was found. 


Example: 


QBFN,102,B,3,,99 '' F4 ,blackbox4 ,V213 


Find blackbox4 in mode 102, type B, RID 3, field number 4. Enter the line number 
where found into variable V2. 


NOTES: 
1. The branch end label, when an error occurs, is 99. 


2. If the field to be scanned is not in ascending order, the result is unpredictable. 





The previous example is the same as entering the following data in the mask of the BF 
manual function. 





Example: 
































*ST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 

*xCD. DATE .IN. TYPE -NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 

Kes SSeees 5  SSSSSssse  SSsess  Sassss sees sass seeess | Sasees  ssesss ssss2,s=s, 

FOR OI OOK IO OI SKK KK KKK KKK KK KKKKKK KR KKK KKK ik 
blackbox4 





5.1.5. @BRK (Break) Run Function 


When a run encounters an @BRK statement, it places all data in the output area into a 
scratch result report (—O) and clears the output area. 


The mode and form type of the output area are the same as those of the run report. 
The mode and form type of the output area can be changed with the @BRK run 
function and not affect the current result. However, it does change the mode and type 
of the output area for the subsequent results created by the @BRK run function. 
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Format: 


@BRK[,mode, type] 


where: 


mode 
Specifies the mode where results subsequent to the current result are placed. 


type 
Specifies the type where results subsequent to the current result are placed. 


If omitted, the same mode and type as the run report, or the last @BRK that 
specified a mode and type, is assigned to the output area. 


In the following example, the run control report is mode 102, type |. The run contains 
three @BRK run function statements, each of which generates a result. The first two 
results are assigned the mode and type of the run, 102,1. The third result is assigned 
the mode and type contained in the second @BRK run function, 102,E. 


Example: 


ABCD 
EFGH 
@BRK DSP,102,1,-@ - RESULT 102,1,-@ 
JKLM 
OPQR 


@BRK,102,E DSP,100,1,-@ . RESULT 102,1,-0 
1234 
5678 
@BRK DSP, 102,E,-@ . RESULT 102,E,-0 





(1) Display of result 


«DATE 83/03/01 06:17:20 
ABCD 


EFGH 





@) Display of result 
-DATE 83/03/01 06:17:25 


JKLM 
OPQR 





Display of result 


-DATE 83/03/01 96:17:30 


1234 
5678 


NOTE: 


Since the MAPPER 80 software automatically sets the date in line 1, processing begins 
on line 2 when reading and writing the result. 
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5.1.6. @CHG (Change) Run Function 
The @CHG run function can perform three possible assignments. These include: 


1. Initializing and redefining the contents of variables with character strings, other 
variables, and reserved words. 


2. Performing arithmetic operations and entering the result in a variable. 
3. Initializing variables with run parameters passed in the reserved word INPUT$. 
NOTE: 


Only variable types A, F, and | can be used in arithmetic operations and as variables for 
entering results. 


Format 1: Initializing variables 


@CHG variable data 


where: 


variable 
Specifies the variable in which to enter data. 


data 
Specifies the data to be entered into the variable. A character string, another 
variabie, or reserved word can be specified. 


Examples: 
@CHG V1H3 ABC 
Enters character string ABC in V1. 
@CHG V2I5 102 


Enters 102 in V2. 


@CHG V3A5 V2 


Enters value of variable V2 in V3. 


@CHG V4I5 STAT1 


Enters the value of reserved word STAT1 in V4. 
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Format 2: Arithmetic operation processing 


@CHG variable expressions 


where: 
variable 
Specifies a variable for entering a result of an arithmetic operation. 
expressions 
Describes the arithmetic expressions. The following guidelines must be 
followed when describing expressions: 
1. Blank characters are required in front of and behind the operators +, -, *. 
2. The slash symbol (/) indicates division and must be enclosed in 
apostrophes with a blank character before and after the apostrophes. 
Example: 
A'/'A 
3. Operating sequence is from left to right. 
4. The operating sequence cannot be changed by using parentheses. 
Parentheses are treated as an error. 
Example: 


@CHG V1I5 V2 + 10 


Enters the sum of the contents of V2 and 10 in V1. 

@CHG V1F6.2 V2 '/' V3 

Divide contents of V2 by contents of V3 and enter the result in V1. 

@CHG V1A5 V4 * V5 

Multiply contents of V4 by contents of V5 and enter the product in V1. 
Format 3: Data acquired from INPUT$ 

@CHG INPUTS variables 


where: 


INPUTS 
Specifies the reserved word containing the run parameters. 
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variables © 


Specifies variables in which data is entered. Multiple variables can be defined 
with each variable being delimited with a comma. 





Example: 


QCHG INPUTS V1A3,V213,V4A5 


Run parameters are entered in V1, V2, and V4. 


5.1.7. @COP (COP Device) Run Function 


The @COP run function prints out the reports or results on a COP printer connected to 
a workstation. 


Format: 


aCOP,mode, type,rid,,, [sequence], [format],,[delete-header],[first-column], 
[spacing], [start-column] 


where: 


mode 
Specifies the mode of the report to be printed. 





type 
Specifies the type (A-l) of the report to be printed. 


rid 
Specifies the report number to be printed. 


sequence 
When Y is specified, line numbers are not printed. 


If omitted, the line numbers are printed. 


format 
Specifies the format number (O—6) used when printing. 


If omitted, the basic format number (0) is used. 


delete-header 
When Y is specified, the header lines of the report are deleted. 


if omitted, the header lines are printed. 


first-column & 


When Y is specified, the character in the first column of each line is not 
printed. 
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If omitted, the first column is printed. 


spacing 
Specifies the number of lines to space (1—9). 


If omitted, the report is single-spaced. 


start-column 
Specifies the first column number to be printed (1—132). 


If omitted, the default value is 1. When both the start-column and first-column 
parameters are specified, the first-column parameter is ignored. 


Example: 


acoP,102,D,1,,,Y,1,,,Y,2 


Request for printout of mode 102, type D and RID 1 report on this workstation’s 
printer. When printing, it deletes header lines, uses format number 1, deletes the 
first column of each line, and double spaces. 


5.1.8. @DEL (Delete Lines) Run Function 


The @DEL run function deletes lines found as a result of an update function such as 
match update (MAU) and search update (SRU). 


Format: 
@DEL 
Example: 
SRU,102,E '' F1 ,OVER 


Create an update result with lines containing OVER in the first-field of the report 
(102,E,2). 


aDEL 


Delete all corresponding lines in the update result from the original report (102,E,2). 


5.1.9. @DLR (Delete Report) Run Function 


The @DLR run function deletes the specified report from the MAPPER 80 data base. It 
is not necessary to display the report before deleting it. Password restrictions are 
disregarded. 








UP-9734 SPERRY OS/3 5-12 


MAPPER 80 RUN FUNCTIONS 


Format: 
@DLR,mode, type,rid 
where: 


mode 
Specifies the mode of the report for deletion. 


type 
Specifies the type of the report for deletion. 


rid 
Specifies the report number for deletion. 
5.1.10. @DSP (Display Report) Run Function 


The @DSP run function displays the specified report at the workstation in the following 
two ways: 


1. Displays the report at the workstation and suspends the run until the manual 
function RSM is entered or function key (F1) is pressed; then the run restarts. 


2. Display the report at the workstation and continues processing of run. The display 
does not change until another @DSP run function is encountered. The run logo is 
displayed on the first line of the screen. 


The @DSP run function can be inserted into specific locations in the run for checking 
intermediate results when debugging. 


Manual updating can also be performed, since the display appears in the form of a 
report or result. Manual functions that can be used are SOE update; add, delete or 
duplicate lines; line O functions; and redisplay line (L and LL). 
To restart the run, enter RSM or press the function key (F 1). 
Format: 

aDSP,mode,type,rid,{start-line],,(format],[inter im] 


where: 


mode 
Specifies the mode of the report to be displayed. 


type 

Specifies the type of the report to be displayed. 
rid 

Specifies the RID of the report to be displayed. 











UP-9734 SPERRY OS/3 5-13 
MAPPER 80 RUN FUNCTIONS 


& start-line 


Specifies the first line number to be displayed. 
If omitted, the display starts from line 1. 


format 
Specifies the format number used when displaying. 


If omitted the basic format number (0) is used. 
interim 
When Y is specified, the run continues processing without being suspended 


after displaying the report. 


If omitted or if N is specified, the run suspends until there is a RSM or F1 key input 
after displaying the report. 


NOTE: 
Other run statements are not allowed on the same line after the @DSP run function. 


Example: When awaiting input after displaying 


& aDSP,102,0,1,,,1 


Displays from the first line of the report in format 1. After displaying it, the run is 
suspended until RSM is entered on line O and the transmit key is pressed, or the 
F1 key is pressed. 

Example: When continuing the run after displaying 


@DSP,102,D,1,,,1,¥ 


Same as the previous example, but the run continues processing after displaying 
one screen. 
5.1.11. @DUP (Duplicate Report) Run Function 


The @DUP run function duplicates the specified report and places it into the same form 
type as the original report. 


The RID number of the duplicated report is set in the reserved word STAT 1. 


Format: 


@ Q@DUP ,mode, type, rid 
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where: 


mode 
Specifies the mode of the report to be duplicated. 


type 
Specifies the type of the report to be duplicated. 


rid 
Specifies the report number to be duplicated. 


Example: 
@aDUP, 102,C,1 
Duplicates mode 102, type C, RID 1 report. 


aCHG V11I3 STAT1 


Initialize V1 to contain the RID number of the new report. 


5.1.12. @ESR (Exit Subroutine) Run Function 

The @ESR run function is used to exit from a subroutine. When the @ESR run function 
command is executed, control is returned to the line following the @RSR command that 
called this subroutine. If a bias (+n or —n) is specified for the @ESR, the subroutine is 
returned to the line that is n lines after or n lines before the line that follows the @RSR 
run function command. 

Format: 


@ESR[,bias] 
where: 
bias 
Specifies the return line number in the format +n (or n), or —n. This bias is 
determined by adding to (+n) or subtracting (—n) from the line after the @ESR 


that called the subroutine. 


If omitted, the bias is assumed to be O, and it returns to the line after the @RSR 
run function command. 


NOTES: 
1. If a bias is specified, the return line must be within the range of the run report. 


2. Other run statements are not allowed on the same line after the @ESR run function. 
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gS ——$—$—_— NT 


& Example: 


@SRH - BIAS -4 
@RNM » BIAS -3 
aMCH » BIAS -2 
@RSR 10 - BIAS 
air » BIAS 
aDSP - BIAS 
alr - BIAS 

@ @SRH » BIAS 

* aGTO - BIAS 
@1@:SRH 
; subroutine 

@ESR 





@ Calls subroutine from label 10. 
@ Returns to the line, after the line it was called from. 
5.1.13. @FND (Find) Run Function 
& The @FND run function searches for the specified item in a report and enters the first 
line number where the item was found into the variable. This run function sets values in 
the following two variables: 
variable 1 Specifies the RID number where the specified item was found. 


variable2 Specifies the line number where the specified item was found. 


When the specified item cannot be found, control is transferred to the label specified. If 
the label is omitted, the next instruction in the run is executed. 


Format: 


@FND,mode, type, [rid], [start-line],[label] options characters [line-typel, 
parameters [variable1],variable2 


where: 


mode 
Specifies the mode of the report to be searched. 


type 
Specifies the type of the report to be searched. 
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rid 
Specifies the report number to be searched. 


If RID is omitted, all RIDs in the type are processed. 


start-line 
Specifies the line-number at which to start searching the report. 


lf omitted, the search starts on line 1. 


label 
Specifies the destination label, if the item is not found. 


If omitted, the next run function is executed. 


options 
Specifies the options. Refer to Appendix B. 


characters 
Specifies the search field, partial field, or characters. 


Line-type 
Specifies the line-type (tab or *) to search. 


If omitted, tab type lines are searched. 


parameters 
Specifies the find parameters. 


variable 
Specifies the variable where the RID number of the found item is entered. 


variable2 
Specifies the variable where the line-number of the found item is entered. 


Example: 


QFND, 102,B,2,,99 '' F4 ,blackbox4 ,V2I5. 


Search report 102,B,2 field 4 for blackbox4 and enter the line-number where found 
into variable2. 


If not found, go to label 99. 


5.1.14. @GTO (Branch) Run Function 


The @GTO run function is used in two ways: 


Branches to the specified line (run function) during the run. 
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2. Terminates the run, closes the output area, and displays the output area as a result. 
Format 1: Branching within a run 


aGTO label 


where: 


label 
Specifies the end of branch. The following four formats are possible: 


label is a label number from 1 through 199. 
variable Is a variable containing a label number from 1 through 199. 
LIN-+n is the number of lines following the present line. The n cannot be 


expressed as a variable; n can be a number between 1 and the 
range of the report. 


LIN—n Is the number of lines preceding the present line. The n cannot 
be expressed as a variable; n can be a number between 1 and 
the range of the report. 


Format 2: End of run 


@GTO END 


where: 


END 
Specifies the end of the run. 


Examples: 


aGTO 10 


Branches to the line labeled 10. 


aCHG V1I13 120 
aGTO V1 


Branches to the line labeled 120. 


aGTO LIN+5 


Branches 5 lines past this line. 
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aGTO LIN-16 


Branches 10 lines in front of this line. 


aGTO END 


Ends the run. 


5.1.15. @IF (Conditional) Run Function 


The @IF run function compares values and makes logical decisions based on the results. 
The types of comparisons are: 


# Simple comparison of equal, greater than, or less than 

= Equal value comparison with multiple values (OR conditional) 
m Range comparison 

Format 1: Simple comparison 


@IF variable operator value action! [;action2] 


where: 
variable 
Specifies the variable for comparison. The maximum length is 64 characters. 
operator 
The following operators are valid for simple comparison: 
Operator Meaning 
= or EQ Equal 
> or GT Greater than 
< or LT Less than 
NOT = or NOT EQ _ Not equal 
NOT > or NOT GT Not greater than 
NOT < or NOT LT Not less than 
value 
Describes data for comparison. Values can be constants, character strings, or 
variables. 
action 


Specifies the run function to be executed when the comparison is equal (true). 
If action! does not contain an @GTO run function then action2 is executed. 
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© action2 


Specifies the run function to be executed when the comparison is not equal 
(false). 


If action2 is omitted, not equal conditions fall through and execute the next run 
function command. 


NOTE: 
Action! and action2 can be compound instructions. The space character separating 
action? from action2 is not required in any of the @IF run function formats. Format 2 is 


an example where the space character is omitted. 


@IF V1 = V2 GTO 1;GTO 2 


Branches to label 1 if V1 is equal to V2; otherwise, branch to label 2. 
Format 2: Equal value comparison with multiple values (OR condition) 


@IF variable operator value1,value2,...,valuen action! [;action2] 


where: 
@ variable 
Specifies the value to be compared. 
operator 
Always specifies the = (equal) operator. 
value1,value2,...,valuen 
Specifies the values for comparison with variable. 
action1 
Specifies the run function to be executed, if the result is true. 
action2 


Specifies the run function to be executed, if the result is false. 
If action2 is omitted and the result is false, the next run function is executed. 
NOTE: 


The result is true, if the variable is equal to any of the values; otherwise, the result is 
false. 


Example: 


& @IF V1 = V2,V3,V4 GTO 1 


Branches to label1 if the contents of V1 is equal to the contents of V2, V3, or V4; 
otherwise, execute the command on the next line. 
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Format 3: Range comparison 





MIF variable operator’ valuet' {é & | operator2 value2 action! [;action2] 
<AND> 


NOTES: 
1. The following operators are valid for range comparisons: 
> or GT Greater than 
<orLT Less than 
& or AND — Conjunction of statements 
2. When operator? is GT, then operator2 must be LT. 
3. When operator! is LT, then operator2 must be GT. 
where: 


variable 
Specifies the value to be compared. 





operator 1 


Specifies GT or LT. 


value 
Specifies the first value to be compared against the variable. 


AND (&) 
Specifies the connective to the second part of the comparison. 


operator2 


Specifies GT or LT. 


value2 
Specifies the second value to be compared against the variable. 


action1 
Specifies the run function to execute, if the result is true. 


action2 
Specifies the run function to execute, if the result is false. 


If action2 is omitted, and the result is false, the next run function is executed. 


NOTE: @ 


The result is true if the variable meets the conditions stated by operator! & value? 
AND operator2 & value2; otherwise, the result is false. 
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Example: 


@aIF V1 > 100 & < 200 GTO 1 
@IF V1 < 50 CHG V1 V1 + 1 


Branch to label 1 if V1 is greater than 100 and less than 200; otherwise, execute 
the command on the next line that adds 1 to V1, if V1 is less than 50. 
5.1.16. @IND (Index) Run Function 


The @IND run function reads a specified number of lines from each report in the 
selected mode and type and then creates a result (index). 


Values are set in two reserved words: 

STAT1 Specifies the number of reports in the type. 

STAT2 Specifies the total number of lines in all reports in the type. 
Format: 


@IND,mode, type, lines[,label][,header] 


where: 
mode 
Specifies the mode of the report to index. 
type 
Specifies the type of the report to index. 
Lines 
Specifies the number of lines (1 through 999) to be read from each report. 
Label 
Specifies the destination label, if no RID exists in the designated mode and 
type. 


If omitted, the next run function is executed. 


header 
When H is specified, the header lines after the first RID are not to be included 


in the index. 
Example: 


@IND,102,B8,5,20,H 
Extracts five lines from each report in mode 102, type B. Do not include report 
headers from second and subsequent RIDs. If no RIDs are found, branch to 


label 20. 
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5.1.17. @INS (Insert) Run Function 


The @INS run function inserts data from one variable to another or inserts constant 
data into a variable. 


Format: 


@INS data variable 


where: 
data 
Describes the data to be inserted in the variable. Constants, character strings, 
and variables can be used. 
variable 
Specifies the variable, the position in the variable and the number of characters 
in the format: Vn(m-—l), where: 
Vn_ Is the variable number. 
m_ Is the position in the variable. 
| Is the number of characters. The m and | can be variables. 
Example: 


@CHG V1H2 QQ CHG V2H3 AAA 
Initialize V1 to OO and V2 to AAA. 


@INS V1 V2(2-2) 
Insert the contents of V1 into V2 at column 2 for two characters. V2 now 


equals AQQ. 


@CHG V4H6 123456 CHG V7I1 3 
Initialize V4 to 123456 and V7 to 3. 


@INS ABCD V4(V7-4) 
Insert ABCD into V4 starting at column V7 for four characters. V4 now equals 


12ABCD. 


@CHG VSH6 SSSSSS CHG V3I1 2 
Initialize V5 to SSSSSS and V3 to 2. 


@INS V4(V3-V7) V5(2-V7) 
Insert the contents of V4 (starting at column V3 for V7 characters) into V5 
(starting at column 2 for V7 characters). V5 now equals S2ABSS. 
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5.1.18. @LCH (Locate and Change) Run Function 


The @LCH run function scans a report in the specified column character positions 
looking for the target string. On each occurrence of the target string, it changes the 
target string in the report to the replacement string. The @LCH run function produces a 
result. 


Format: 


@LCH,mode, type,rid,[start-line],{label] option characters target-string 
/replace-string [,variable2,variable3] 


where: 


mode 
Specifies the mode of the report to scan. 


type 
Specifies the type of the report to scan. 


rid 
Specifies the report number to scan. 


start-line 
Specifies the line-number at which to start. 


Label 
Specifies the destination label when the target string cannot be found. 


If omitted, the next run function is executed. 


options 
Specifies the options. Refer to Appendix B. 


characters 
Specifies the columns, fields, or partial fields to be scanned. 


target-string 
Specifies the target string (maximum of 32 characters). 


replace-string 
Specifies the replacement string (maximum of 32 characters). 


var iable2 
Specifies the variable for entering the number of lines that contained the target 
string. 


var iable3 
Specifies the variable for entering the RID number where the target string was 
located. 
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In the @LCH run function, the relationship between the options and the target-string and 


replace-string is as shown in Table 5—1. 


Table 5-1. Target-String/Replace-String Relationship 


| Options | Target-String Replace-String 


Line type to be First character of Ignored, but must 
scanned (tab or *) target-string contain fill 
character 






First character of 
replace-string 
























First character of 
replace-string 






Ignored, but must First character of Ignored, but must 
contain fill target-string contain fill 
character character 


target-string replace-string 


Line type to be 
scanned 










New line type 
when replacment 
occurs 


First character of 
target-string 


First character of 
replace-string 



















Examples: 


@LCH,mode,type,rid '' 1-128 ]ABC/ (@ DEF ,V2,V3 
Only tab lines are scanned. 

@LCH,mode,type,rid A 1-128 @ ABC/ @ DEF ,V2,V3 
All lines are scanned. 

@LCH,mode,type,rid F 1-128 ABC/DEF ,V2,V3 

All lines are scanned. 


@LCH,mode,type,rid M 1-128 JABC/*DEF ,V2,V3 








Only tab lines scanned. Line type is changed to * when replacement has occurred. 
y p 


NOTES: 


The @) is a fill character. 


If your target-string includes spaces, use the oD) fill character for assigning the 


transparent character to another character value. 


5.1.19. @LLN (Last Line Number) Run Function 


The @LLN run function sets a variable equal to the last line number of the specified 


report. 
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Format: 


@LLN,mode,type,rid[,label] variable 


where: 


mode 
Specifies the mode of the report to be checked. 


type 
Specifies the type of the report to be checked. 


rid 
Specifies the report number to be checked. 


label 
Specifies the destination label when the specified report does not exist. 


If omitted, the next run function is executed. 


variable 
Specifies the variable in which to enter the last line number of the report. 


Example: 


ALLN, 102,B,1,99 V113 


The last line number of the report is entered in variable V1. 


5.1.20. @LNX (Duplicate Line) Run Function 

The @LNX run function duplicates lines in the report. The maximum number of lines that 
can be duplicated is 23. The duplicate quantity parameter allows lines to be duplicated 
from 1 to 99 times. For example, 1 line can be duplicated 99 times, 23 lines can be 
duplicated 4 times, or any other combination within the guidelines (lines to be duplicated 
can equal a maximum of 23, while duplicated lines can equal 99.) 


Before executing this instruction, you must lock this report with the @LOK run function 
command. 


Format: 
@LNX,mode,type,rid,start-line,dupl icate-quantity[,size] 
where: 


mode 
Specifies the mode of the report requiring duplication. 
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type 
Specifies the type of the report requiring duplication. 





rid 
Specifies the report number requiring duplication. 


start-line 
Specifies the first line number to be duplicated. 


dupl icate-quantity 
Specifies the number (n) of times that the same line or lines is to be 
duplicated. 

size 
Specifies the number of lines (p) up to 23 to be duplicated. The default value 
is 1 and (n x p) must be less than or equal to 99. 


Examples: 


@LNX, 102,B,10, 10,5 
Duplicates the tenth line five times. 


@LNX,102,B,30,20,4,5 & 





Duplicates five lines starting with line 20 four times. A total of 20 lines are 
duplicated in the report. 
5.1.21. @LN+ (Add Line) Run Function 
The @LN+ run function adds lines to the report. The line defined in RID O of the 
specified report type is used as the line to be added. A maximum of 99 lines can be 
added with one @LN-+ run function. 
Lock this report prior to executing the @LN+ run function command. 
Format: 
aLN+,mode,type,rid,start-lLine,line-quantity [,line-number] 
where: 


mode 
Specifies the mode of the report to which the line is added. 


type 
Specifies the type of the report to which the line is added. 
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rid 
Specifies the report number to which the line is added. 


start-line 
Specifies the line number after which lines are added. 


Line-quantity 
Specifies the number of lines to add. A maximum of 99 lines can be added. 


Line-number 
Specifies the predefined line number (O through 9) to be added. The default is 
O (normally a blank tab line). 
Example: 


ALN+,102,C,5,40,10,2 


Add 10 lines of predefined line number 2 from RID O after line 40. 


5.1.22. @LN- (Delete Line) Run Function 


The @LN- run function deletes from 1 to 999 lines from a report. The @LN— must be 
preceded by an @LOK run function command. 


Format: 


aLN-,mode,type,rid,start-line,line-quantity 


where: 
mode 
Specifies the mode of the report having lines to be deleted. 
type 
Specifies the type of the report having lines to be deleted. 
rid 


Specifies the report number having lines to be deleted. 


start-line 
Specifies the first line number to be deleted. 


Line-quantity 
Specifies number of lines to be deleted. 


Example: 
@LN-,102,C,5,41,10 


Deletes 10 lines starting at line 41. 
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5.1.23. @LOK (Update Lock) Run Function @ 





The @LOK run function temporarily prevents other users from updating the report 
currently being updated. Use an @LOK command before an @LNX, @LN+, @LN-, or a 
@WRL run function, or else the run ends in error. 


If another user already has update control of the report, the run stalls until that user 
releases control. 


The lock can be released by the following actions: 
1. Execution of the @ULK run function 
2. Execution of the @LOK run function on other reports 


3. Execution of the following run functions: 


@ADD, @ADR, DAUX, OBFN, @BRK, @COP, ADEL, @DLR, @DSP, ADUP, @FND, @IND, 
@LCH, @LLN, @MAU, OMCH, OPRT, ARDC, ARDL, @REP, ARLN, @ARNM, ARUN, 
@SOR, @SRH, @SRU, ASUB, ATOT, AUPD 


4. End of run functions: @REL, @X!IT, @GTO END or when a run ends in error 


Format: 





a@LOK ,mode, type,rid 


where: 
mode 
Specifies the mode of the report to be locked. 
type 
Specifies the type of the report to be locked. 
rid 
Specifies the RID of the report to be locked. 
Example: 
aLOK,102,D,1 


The mode 102, type D, RID1 report is locked. 
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5.1.24. @MCH (Match) Run Function 


The @MCH run function compares fields in two different reports. When a match is 
detected, it transfers the contents of a specified field in the issuing report to the 
specified field of the result. The result produced by this report is a copy of the receiving 
report with the transfer fields blanked out or, updated with the data transferred from the 
issuing report. The contents of the result will vary depending on the options you 
specify. When the P option is specified, the following values are assigned in the two 
reserved words: 


STAT 1 Specifies the number of matched lines or number of unmatched lines 
when the N option is specified. 


STAT2 Specifies the number of lines of the receiving report on which a match 
was attempted. 


Format: 


a@MCH,mode1, type1,rid1,mode2,type2,rid2,[label] options characters1 
[lLine-type1],parameters1 characters2 [line-type2],parameters2 


where: 


mode1 
Specifies the mode of the issuing report. 


type 
Specifies the type of the issuing report. 


rid1 
Specifies the report number of the issuing report. 


mode2 
Specifies the mode of the receiving report. 


type2 
Specifies the type of the receiving report. 


rid2 
Specifies the report number of the receiving report. 


Label 
Specifies the destination label when the comparison fields have not been 
sorted and the P option was specified. 


options 
Specifies the options. Refer to Appendix B. 


characters! 
Specifies the comparison fields and the transfer fields of the issuing report. A 
maximum of 5 comparison fields with a maximum of 36 characters can be 
specified. A maximum of 13 transfer fields can be specified. 
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line-type1 
Specifies the line type (tab) to be processed by the issuing report. 





parametersi 
Specifies the comparison fields (1 through 5) and the data transfer fields (A—M) 
of the issuing report. 


characters2 
Specifies the comparison fields and the data transfer fields in the receiving 
report. 


Line-type2 
Specifies the line type (tab) of the receiving report. 


parameters2 
Specifies the comparison fields (1 through 5) and the data transfer fields (A—M) 
in the receiving report that correspond to parameters1 in the issuing report. 
Example: 


@MCH,102,C,1,102,B,2 '' F1,F3 ,1,A F4,F6 ,1,A 


There are no labels or options specified in the example. 





m ~= Issuing Report 


F1 
Is the comparison field in the issuing report. 

F3 
Is the third field in the issuing report and the field from which data is 
transferred to the result. 

1 
Is the first match parameter in the issuing report. It relates to F1 and 
means that F1 is the first field in the issuing report to be compared to the 
corresponding first field in the receiving report (F4). A maximum of five 
fields (1 through 5) can be compared. 

A 


Is the first data transfer field in the issuing report. It relates to F3 
indicating that, when a match occurs, the contents of F3 transfers to the 
corresponding A (F6) field in the result. A maximum of 13 fields (A—M) 
can be transferred. 


m= Receiving Report 


F4 





Is the fourth field in the receiving report. It is compared against F1, the 
first field in the issuing report. 
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F6 
Is the sixth field in the receiving report. This indicates the transfer-to field 
that receives the transferred data from F3 of the issuing report. 

1 
Is the first match parameter in the receiving report. It relates to F4 and 
means that F4 is the first field in the receiving report to be compared to 
the corresponding first field in the issuing report (F 1). 

A 


Is the first data receive field in the receiving report. It relates to F6 and 
indicates that, when a match is found, the contents of the corresponding 
A field in the issuing report (F3) is transferred to the first data transfer 
field (F6) in the result. If no match is found, this field is made blank. 


The following is a comparative example using the MA manual function. It compares the 
Product Type fields of two reports. If they match, the data in the Product Cost field is 
transferred from the issuing report to the result. 


Example of Issuing Report: 


LINE> 1 FMT> RL> SHFT> HLD CHR> HLD LN> PSWD> > 
-DATE 83/06/29 13:07:49 TYPE=C RID=001 83/06/29 JDOE < 24 LINES> 
. <<< CORPORATE FACTORS BASE >>> 
* PRODUCT . SUB .PRODUC. WHOLE . RETAIL . SALES .SPACE. DEMO 

TYPE . KEY . COST . SALES . $$$$ .COMMISS. REQ “QUANTITY. DEMO RESULTS . 
keeasnszse Veccee, ahewee® ScSiecs SS eens es ces eces Seeks, SesSssee Sa skeeerecetoes, 


BLACKBOX1 A 13500 16875 23625 2362.50 
BLACKBOX2 A 13600 17000 23800 2380.00 
BLACKBOX3 A 13700 17125 23975 2397.50 


















































LINE> 1 FMT> RL> SHFT HLD CHR> HLD LN> PSWD> > 
-DATE 83/07/05 10:47:50 TYPE= B. RID=002 83/06/29 JDOE < 48 LINES> 
. <<< CORPORATE PRODUCTION STATUS >>> 

xST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
rion DATE .IN. TYPE .NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE sORDER. coD. 


TP 741224 LS BLACKBOX1 436767, "84389 AMCO 741223 741224. 
IP 741225 LS BLACKBOX1] 436768 84390 AMCO 741223 741225 
IP 741219 LS BLACKBOX2 637071 84353 INTR 741218 741219 
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Example of Match Mask: 
























































PRODUCT . SUB .PRODUC. WHOLE . RETAIL . SALES .SPACE. DEMO . 
TYPE . KEY . COST . SALES . $$8$$ .COMMISS. REQ .QUANTITY. DEMO RESULTS 


1 a 
ST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
CD. DATE .IN. TYPE .NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 


1 a 





5.1.25. @MAU (Match Update) Run Function 

The @MAU run function performs essentially the same operation as the @MCH run 
function. However, using the update results generated by the MAU run function, you 
can replace or delete lines in the original receiving report. 


Execution of the @MAU run function causes the receiving report to be locked until 
execution of the @UPD or @DEL run functions. 


Format: 


@aMAU ,mode1, type1,rid1,mode2,type2,rid2,[label] options characters1 
[line-type1],parameters1 characters2 [line-type2],parameters2 


NOTE: 
Refer to the @MCH run function (5.1.24) for parameter definitions of @MAU. 
Example: 


@MAU,102,C,1,102,B,2 M F1,F3 ,1,A F4,F6 ,1,A 
aUPD 


Execution of this run statement produces an update result. This update result is 
exactly the same as the result produced by the @MCH example (5.1.2.4). The only 
difference is that the contents of this update result can be used to replace or delete 
corresponding lines in the original receiving report. 


The @UPD run function replaces lines in the original receiving report (102, B, 2) 
with corresponding lines in the update result. 
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5.1.26. @PRT (Print) Run Function 
The @PRT run function prints reports on the system printer. 
Format: 


@PRT,mode, type,rid,,[format],,,,{spacing} 


where: 
mode 
Specifies the mode of the report to be printed. 
type 
Specifies the type of the report to be printed. 
rid 
Specifies the RID number of the report to be printed. 
format 
Specifies the format number (O through 6) used when printing. 
If omitted, it defaults to O (basic format number). 
spacing 
Specifies the number of line advances when printing (1 through 9). The default 
is 1. 
Example: 


MPRT,102,D,1,,1p¢er2 


Print the report in format 1, double space. 


5.1.27. @RDC (Read Continuous) Run Function 

The @RDC run function reads a specified number of data lines continuously from the 
report. The data lines read must be sent to the output area with the output line located 
after this instruction; otherwise, the run ends in error. 


Format: 


ARDC, mode, type, rid,start-line,line-quantity, [Line-type], [label] 
characters variables 
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where: 





mode 
Specifies the mode of the report to be read. 


type 
Specifies the type of the report to be read. 
rid 
Specifies the report number of the report to be read. 


start-line 
Specifies the starting line number. 


Line-quantity 
Specifies the number of lines to be read. 


Line-type 
Specifies the line type. 


If omitted, all line types are read in. 
label 


Specifies the destination label if the starting line number does not exist or if 
the last line number is reached during the read. 





characters 
Specifies fields, partial fields, or character columns to be read in the line. 


variables 
Specifies the variables where the data goes. 


NOTES: 


1. The @RDC run function must not be followed on the same line by another run 
function. 


2. The line following the @RDC run function must be an output line. 
Example: 


ARDC, 102,C,1,6,10,,40 F1,F3 V1A9,V216 


Reads 10 lines starting from the sixth line of mode 102, type C, RID 1 report and 
writes the first and third fields into variables (V1 and V2. Product Type = V1 and 
Product Cost = V2. 


PRODUCT TYPE=V1 PRODUCT COST=V2 





Write the data to the output area. 
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5.1.28. @RDL (Read Line) Run Function 

The @RDL run function reads in one line of data from a specified report. After executing 
this function, the next line number to be read is entered in the reserved word: LINES. 
When the END REPORT line is read, a zero is entered in LINE$. 


Format: 


@RDL,mode,type,rid,line({,label] characters variables 


where: 


mode 
Specifies the mode of the report. 


type 
Specifies the type of the report. 


rid 
Specifies the report number. 


Line 
Specifies line number to be read. 


label 
Specifies the destination label when the line number to be read does not exist. 


characters 
Specifies the fields, partial fields, or character columns to be read in the line. 


variables 
Specifies the variables where the read in data goes. 


Example: 


@RDL,102,B,2,6,99 F1,F2,F4 V1A2,V2A6,V35A9 


5.1.29. @REL (Release) Run Function 


The @REL run function releases the workstation, terminates the run, and displays the 
user logo. 


Format: 


@REL 





UP-9734 SPERRY OS/3 5-36 
MAPPER 80 RUN FUNCTIONS 


5.1.30. @REP (Replace) Run Function 
The @REP run function replaces a receiving report with an issuing report. 


On execution, the contents of both reports become identical. Result names (—O to —4) 
can be specified for the issuing report but not for the receiving report. 


NOTE: 
The line length of both reports must be the same. 
Format: 

@REP ,mode1,type1,rid1,mode2,type2,rid2 
where: 


mode 1 
Specifies the mode of the issuing report. 


type 
Specifies the type of the issuing report. 


rid1 
Specifies the report number of the issuing report. 


mode2 
Specifies the mode of the receiving report. 


type2 
Specifies the type of the receiving report. 


rid2 
Specifies the report number of the receiving report. 
Example: 


@REP,20,E,5,40,E,10 


Replace mode 40, type E, RID 10 with mode 20, type E, RID 5 report. 


5.1.31. @RLN (Read Next Line) Run Function 


The @RLN run function reads one line of data from a report. The report was specified 
by the @RDL run function that was executed immediately prior to the @RLN run 
function. The line number read is the line number specified in this run function or, if 
omitted, the line number contained in the reserved word LINES. After the last line is 
read, LINES contains 0. 
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If certain run functions are executed between the @RDL and @RLN run functions or 
between an @RLN and the next @RLN run function, an error results. These run 
functions include: 


@ADD, MADR, AUX, OBFN, OBRK, @COP, ADEL, @DLR, ADSP, OFND, MIND, @LCH, A@LLN, 
@LNX, @LN+, @LN-, @LOK, A@MAU, @PRT, ARDC, ARDL, REP, ARNM, ARUN, SOR, ASRH, 
@SRU, @SUB, @TOT, @ULK, @UPD, AWRL 


Format: 


@RLN, (lLine][, label] characters variables 


where: 


Line 
Specifies line number to be read. 


If omitted, the line number contained in the reserved LINE$ is read. 


label 
Specifies the destination label when the specified line number does not exist. 


characters 
Specifies the fields, partial fields, or character columns to be read in the line. 


variables 
Specifies the variables that contain the data read in. 


Example: 


@RDL,20,F,4,100,99 F1,F2,F3-24 V1A4,V214,V3S24 — Read line 100 of the mode 20, 
type F, RID 4 report. Enter the 
data in F1 into V1, F2 into V2, 
and the first 24 characters of F3 


into V3. 
v1 V2 v3 Write V1, V2, and V3 to 

the output area. 
aGTo 1% Branch to the line labeled 11. 
Q1@:RLN,,99 F1,F2,F3-24 V1,V2,V3 Read in the line contained in the 


reserve word LINES and enter the data 
in F1 into V1, F2 into V2, and the 
first 24 characters of F3 into V3. 


v1 v2 V3 Write V1, V2, and V3 to 
the output area. 

@11:CHG V9I3 LINES Initialize VQ with the contents of 
the reserved word, LINES. 

OIF V9 < 200 GTO 106 If the next line number is 


less than 200, 

loop back to the line labeled 10. 

lf the next line number is equal to 

or greater than 200, execute the 

next run function. 
099:BRK DSP,20,F,-® Display the output area on the screen. 
aXxIT Terminate the run. 
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5.1.32. @RNM (Rename) Run Function @ 





The @RNM run function establishes a new reference number for a report or result. This 
number can be: —1, —2, —3, or —4, in any order. This run function is especially useful 
for temporarily saving multiple results. 


The same number can be used as often as you like; however, each time the number is 
used, its previous contents are erased. The temporarily saved data is completely erased 


at the end of the run. Therefore, permanent updating must be completed before the end 
of the run. 


Renamed reports can be referenced by their renamed numbers (-—1 to —4). 
Format 1: Renaming the result —O 


@RNM -n 


where: 


Specifies the new result number (—1 to —4) of result (—O). 
Example: 


@RNM -2 
aSOR,102,B,-2 





Renames the result —O to result —2 and then sorts it. 


Format 2: Renaming the report 
ORNM,mode,type,rid —-n 


where: 


mode 
Specifies the report to be renamed. 


type 
Specifies the type of the report to be renamed. 


rid 


Specifies the report number of the report to be renamed. 


Specifies the result number (—1 to —4) to be assigned to the report. 


Example: 





QRNM,102,C,1 —3 


Renames the report 102,C,1 to result (—3). 


UP-9734 SPERRY OS/3 5-39 
MAPPER 80 RUN FUNCTIONS 








5.1.33. @RSR (Run Subroutine) Run Function 


The @RSR run function calls and executes subroutines within the same run report. A 
subroutine is a series of run functions that starts with a label and ends with the @ESR 
function. Return from the called subroutine is accomplished by the @ESR. 


Subroutines can also call other subroutines. This is called subroutine nesting, and a 
maximum of 10 levels can be nested. Other run function commands must not appear on 
the same line after the @RSR. 


Format: 


@RSR Label 


where: 


label 
Specifies the entrance label (1 through 199) of the subroutine. 


Example: 


@RSR 1 Execute subroutine at label 1. 
@ . control statement a 
@ . control statement b 
a@ . control statement c 
@GTO END . 

a1: subroutine control statement a 
@ . subroutine control statement b 
@ . subroutine control statement c 
MESR . 










Subroutine statements 


End the subroutine and return to calling 
RSR + 1 line (statement a). 


5.1.34. @RUN (Start Run) Run Function 


The @RUN run function ends the run being executed (RUN1), and starts execution of a 
successor run (RUN2). A run cannot name itself as the successor run. 


RUN1 can transfer to RUN2 a maximum of 40 different variables and/or constants (with 


a maximum of 320 characters). These data are entered in the reserved word INPUTS. 


RUN2 can access the transferred data in the reserved word INPUT$ by using the @CHG 
run function. 


The result (-O) created in run number 1 can be used in run number 2. 
Other run functions must not appear on the same line after the @RUN function. 
Format: 


@RUN run-name[,data] 





UP-9734 SPERRY OS/3 5-40 
MAPPER 80 RUN FUNCTIONS 





where: 
run-name 
Specifies the run name of run number 2. 
data 
Specifies the variables and constants to be passed to run number 2. Each data 
segment is delimited by a comma. 
Example: 
(RUN1) 
@CHG V1IH4 1234 CHG V2H3 STNUMS Initialize variables to be passed to RUN2. 
@RUN RUN2Z,V1,V2, TEST Start the RUN2. 
CRUN2) 
@CHG INPUTS V1H4,V2H3,V3H4 Initialize variables with data passed from RUN1. 
@RNM -1 Rename result (-O) from RUN1 to —1. 
aBRK 


5.1.35. @SFS (Display Screen Format) Run Function 


The @SFS run function displays, at the workstation, the formatted screen that the user 
created with the system utility routine (screen format services). Refer to the OS/3 
screen format services, concepts and facilities, UP-8802 (current version). 


Fields in the formatted screens can be defined as output, input, or input/output. 
Output-only fields display data. Input-only fields accept input data. Input/output fields 
display data and accept input data. 

If the screen displayed by the @SFS run function contains input/output or input-only 
fields, the run is temporarily suspended. This suspension continues until the data is 
keyed into these fields and transmitted. The input data is written into the variables 
specified in the @SFS input-data parameter. 


if the screen contains only output fields, the next run function is executed immediately 
after displaying the screen. 


Format: 


aSFS format-name [output-data][/input-data] 


where: 
format-name 
Specifies the SFS format name to be displayed. This must be _ four 
alphanumeric characters with the first character being the jetter U. 


This SFS format name must be registered in the screen format file. 
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output -data 


Defines the output variables and constants to be inserted in the output and 
input/output fields. 


When there is multiple data, each data segment is delimited by a comma. 

The total number of characters of the data defined here must be equal to the 
total number of characters of the output and/or the input/output fields of the 
@SFS format to be displayed. A six position field must contain six characters. 
If this does not match, the run ends in error. 


Omit this field when the screen contains no output or input/output fields. 


input-data 


Specifies the variables receiving the input data. When multiple variables are 
specified, each variable must be delimited with a comma. Variables do not 
have to be specified when there are no input or input/output fields in the 
format. 


Fields in your defined screens can include any of the basic character types (A, 9, X). 
However, the editing characters (sign, comma, and period in a numeric field) are not 
supported. 


Examples: 


The following is a screen display of the SFS format name UAC1 and this screen is 
created using the system utility routine, Screen Format Services. 





























DATE: uuuuuu 





<<< PLEASE ENTER THE REQUESTED DATA >>> 


SALES PERSON ee Se 
PRODUCT TYPE - (www) 
ORDER QUANTITY s- “a8? 


uuuuuuU 


Specifies output field. 


Specifies input field. 


When: 


Q@CHG V1I6 DATE1$ Initialize V1 with date. 
@SFS UAC1 V1/V2A5,V3A4,V414 Display SFS screen UAC1. 
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are executed, the following format is displayed: 























———— 
== 

















=< ———— 














<<< PLEASE ENTER THE REQUESTED DATA >>> 


DATE: 830714 


SALES PERSON - (__.) 
PRODUCT TYPE = € a) 
ORDER QUANTITY - (lw) 








Data entered into the SALES PERSON, PRODUCT TYPE, and ORDER QUANTITY 
fields are set into the variables V2, V3, and V4, respectively. 


Examples: 
When there is no output data: 


@SFS UAG2 /V113,V2A3 


When there is no input data: 





@SFS UA®3 ABC 
When there is no input or output data: 
@SFS UAG4 


When there is input/output data: 








@CHG V1A6 DATE1$ 
@CHG V2A3 RSM 
@SFS UAO4S V1,V2/V2 


@IF V2= 'HLT' GTO 99 


a99:XIT 


Initialize V1 with the date. 

Initialize V2 with RSM. (This is an input/output field.) 

Display SFS screen UAO4 and suspend the run. You can change the 
data in the input/output field from RSM to HLT to terminate the run 
or leave RSM in the input/output field. in either case, press the 
transmit key to continue the run. 

If the input/output field is HLT, go to line labeled 99; 

otherwise, execute the next run function. 


Terminate the run. 
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5.1.36. @SOR (Sort) Run Function 
The @SOR run function sorts lines in a report in ascending or descending order and 
produces a result. Sort keys can be specified for up to five fields. Each key can be 


designated as ascending (numeric or character) sequence or descending (numeric or 
character) sequence. 


Format: 


@SOR,mode,type,rid options characters [line-type],parameters 


where: 
mode 
Specifies the mode of the report to be sorted. 
type 
Specifies the type of the report to be sorted. 
rid 
Specifies the report number of the report to be sorted. 
options 
No options are available. Use apostrophes as shown in the example. 
characters 
Specifies the fields to be sorted with a maximum of 5 fields and a total of 36 
or fewer characters. 
Line-type 
Specifies the line type (tab or *) to be processed. 
parameters 
Specifies the parameters of the sort fields (1 through 5) and A (ascending), D 
(descending), and N (numeric) order. 
NOTES: 


1. The sort level (1 — 5) must be specified. 
2. When the A or D parameter is not specified, the default is A. 


3. The N parameter is used in combination with the sort level and the A or D 
parameters, for example, 2DN, or 2AN, or 2N. 


4. When the N parameter is specified, the data is sorted in numeric sequence. 


5. When the N parameter is not specified, the data is sorted according to the 
Series 8O EBCDIC code table (character sequence). 
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Example: 





@SOR,192,B,2 '' F2,F4,F7 ,1,3D,2N 


Sort the second field of mode 102, type B, RID 2 report in ascending order. The 
sort key is at the first level and at the seventh field with the sort key at the second 
level by numerical value in ascending order. Then sort the fourth field in descending 
order with the sort key at the third level. 


5.1.37. @SRH (Search) Run Function 


The @SRH run function searches vertically through a report and creates a result with the 
lines found. 


Format: 


@SRH,mode, type, [rid], {start-line],(line-quantity], [label] options 
characters [line-type],parameters [variable1],[variable2] 


where: 


mode 
Specifies the mode of the report to be searched. 





type 
Specifies the type of the report to be searched. 


rid 
Specifies the report number to be searched. If RID is omitted then all RIDs are 
searched. 


start-line 
Specifies the starting line number of the search. 


line-quantity 
Specifies the number of lines to be searched. 


label 
Specifies the destination label when specified data cannot be found. 


options 


Specifies options (Appendix B). 


characters 
Specifies the fields, partial fields, or character columns to search. 


Line-type 
Specifies the line type (tab or *) to search. 
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parameters 
Specifies the search parameters. 


variable 
Specifies the variable where the number of lines found is entered. 


var iable2 
Specifies the variable where the number of lines searched is entered. 


Examples: 
When the parameter is an AND condition: 


@SRH,102,B,2 '' F1,F4 ,SC,blackbox5 V113,V214 


When the parameter is an OR condition: 


@SRH,102,B8,2 '' F8 ,AMCO/,FEDS V113,V214 


When the parameter is a range search: 


@SRH,102,B,2 '' F5,F4-8 ,100000,blackbox/R, 706000 V1I3,V214 


5.1.38. @SRU (Search Update) Run Function 


The @SRU run function searches vertically through a report and creates an update result 
with the lines found. The lines of the original report corresponding to the lines of the 
update result can be deleted with the @DEL run function or updated with the @UPD run 


function. 
Format: 


aSRU,mode,type,rid, [start-line],[line-quantity],[label] options 
characters [line-type],parameters [variable1],{variable2] 


NOTE: 


Refer to the @SRH run function (5.1.37) for definitions. The only exception is that 
the RID must be specified when using the @SRU run function. 
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Example: 


@SRU,102,B,4,,99 '' F2-4 ,8001/R,8012 V1I4,V215 


Searches for lines in which the four characters from the first column of the second 
field of the RID 4 report are in the range 8001 to 8012. Branch to label 99 if no 
lines are found. The number of lines found is entered in variable V1, and the 
number of lines searched is put in V2. 


aDEL 


Delete the found lines from the original report. 


5.1.39. @SUB (Subtotal) Run Function 


The @SUB run function calculates the subtotal of a field or fields based on a change in 
the specified key. Follow the @SUB function directly with an output line, since one line 
of output is created for each subtotal. 


When there is no output line, if the line directly after the @SUB is not an output line, or 
if the output line does not contain the variable defined in the @SUB function, the run 
ends in error. 


Format: 


aSUB,mode,type,rid,[label] options characters 
[line-type],parameters variables 


where: 


mode 
Specifies the mode of the report. 


type 
Specifies the type of the report. 


rid 
Specifies the RID number of the report. 


Label 


Specifies the destination label if the line-type (tab or *) to be processed is not 
in the specified report. 


options 
Refer to options in Appendix B. 


characters 
Specifies the fields to subtotal. 


Line-type 
Specifies the line type (tab or *) to be processed. 
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@ parameters 


Specifies the processing control parameters. The following three control 
parameters can be used for this parameter: 


S_ Specifies the key field. The length must be within 24 characters. 

+ Specifies the fields to be subtotaled with a maximum of 16. 

M_ Specifies that the designated field in the last line of the key group be 
entered in the variable. The M is optional and a maximum of 16 characters 


can be specified. 


variables 
Specifies the variables that contain the processing results. 


When the E option is specified, the first variable contains the number of entries 
of the specified line-type of each subtotal group. When there is no 
specification of option E, this variable is the same as the second variable. 

The second and subsequent variables contain data corresponding to the 


symbol specified by the parameter. Refer to the parameter definitions of S, +, 
and M. 


& NOTES: 
1. Other run functions are not allowed on the same line after the @SUB run function. 


2. The line after the @SUB run function must be an output line that contains the 
variables defined in the @SUB run function. 


Example: 
The report to be processed by the run example is 102,D,2. The run report is in 
mode 102, type B, and the result produced by the run is in mode 102, type B, RID 
(0). 


Report contents: 

















LINE> 1 FMT> RL> SHFT > HLD CHR> HLD LN> PSWD> > 
-DATE 83/07/13 12:24:15 TYPE=D RID=002 83/07/13 JDOE < 20 LINES> 
. <<< CORPORATE ORDER STATUS >>> 

ST.ORDER . PRODUCT .ODR.CUST. UNIT .EXTENDED.REQ'D .SALE. 

xCD.NUMBER. TYPE -QTY.CODE. RETAIL . RETAIL .DELIVR.REP . CUSTOMER 





OR 999515 GREENBOX9 Z AMCO 26775 53550 750312 DJR AMERIAN OIL CO. 73 
OR 99951S GREENBOX7 1 AMCO 26075 26075 750312 DJR AMERIAN OIL CO. 73 
OR 99951S BLACKBOX9 1 AMCO 25025 25025 750312 DJR AMERIAN OIL CO. 73 
OR 96652S GREENBOX4 2 ARCO 25025 50050 750412 LSJ ARGENTINE CORP. 23 
OR 96652S BLACKBOXS 1 ARCO 24325 24325 750412 LSJ ARGENTINE CORP. 23 
OR 96652S BLACKBOX4 1 ARCO 24150 24150 750412 LSJ ARGENTINE CORP. 23 
OR 99753S GREENBOXS 1 DICO 25375 25375 750312 LSJ DIGITAL CORP 17 
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Define the run: 












































= @BRK 
= CUSTOMER ENTRIES ORDERS EXTENDED RETAIL 
= @SUB,102,D,2 E F4,F7,F10 ,+,+,5 V1I3,V213,V318,V4817 
= v4 vl v2. sV3 
= @CTO END 
i Te END REPORT ..... 
where 
@BRK 


Clears the output area. 


@SUB,102,D,2 E F4,F7,F10 ,+,+,S V213,V213,V318,V4S17 


where: 


102,D,2 
Specifies the report to be subtotaled. 


® 
Specifies the option that produces a count of the number of entries per 
line-type, per subtotal group. 


F4,F7,F10 
Specifies the fields to be processed. 


F4 Is the fourth field in the report (ORD QTY). 
F7 ls the seventh field in the report (EXTENDED RETAIL). 


F10 Is the tenth field in the report (CUSTOMER). 


+,+,5 


ar ae 


Specifies the control parameters to accumulate the subtotals for F4 and F7 
by subkey F10. 


V113,V213,V318,V4S17 
Specifies the variables that contain the results: 


V1 Contains the number of entries. 


V2 Contains the subtotal for F4 (ORD QTY). 





V3 Contains the subtotal for F7 (EXTENDED RETAIL). 


V4 Contains the subtotal key (CUSTOMER). 
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V4 V1 V2 V3 
Writes the results to the output area. 


aGTO END 
Displays the results and terminate the run. 


Results produced by the run: 







LINE> 1 FMT>  RL> SHFT > HLD CHR> HLD LN> PSWD> ''RESULT''> 
DATE 83/07/14 15:33:05 TYPE=B RID= 83/07/14 MAPR < 11 LINES> 











AMERIAN OIL CO. 3 4 104650 
ARGENTINE CORP. 3 4 98525 
DIGITAL CORP 1 1 25375 
FED SYSTEMS CORP | 4 4 75250 
INTERNATIONAL CO 1 1 24150 
UNION STEEL/SULFR 2 51800 






5.1.40. @TOT (Totalize) Run Function 


The @TOT run function creates results by performing arithmetic, move and fill 
operations on fields within a report. 


Format: 


aTOT,mode,type,rid,(ltabel] options characters 
[line-type],parameters [variables] 


where: 


mode 
Specifies the mode of the report to be totalized. 


type 
Specifies the type of the report to be totalized. 
rid 
Specifies the report number of the report to be totalized. 


Label 
Specifies the destination label when no lines are found. 


options 
Specifies options (Appendix B). 


characters 
Specifies the fields, partial fields, or character positions to be processed. 
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Line- type 
Specifies the line type (tab type) to be processed. 





parameters 
Specifies parameters corresponding to the field to be processed. These 
include: +, -,*, /, =, A, M, §, C 
where: 
A Specifies average. 
M_ Specifies move. 
S_ Specifies subtotal. 
C 


Specifies cumulation. 


variables 
Specify the variables to hold the results. Variables are effective only for vertical 
totalizations and average calculations. They are ignored for other operations 
(horizontal calculations, move data, etc). The output generated for the vertical 
and average operations can, depending on the inclusion or omission of 
variables, be of two formats. 


Format 1 — Inclusion of variables: 





The output consists only of totals contained in the variables. 
Format 2 — Omission of variables: 


The output consists of a result report with the totals, as part of the report, 
included at the end. 


NOTES: 


1. When specifying the E option, the first variable contains the number of data 
lines (the number of entities) processed. 


2. Vertical total or average calculation results are entered in the second and 
subsequent variables. 


3. When no E option is specified, all variables contain the vertical total or average 
calculation results. 


4. The maximum number of effective digits of the calculation result is 15. Digits 
after the fifteenth are truncated. 


Examples: 





@TOT,192,C,1,99 '' F4,F6,F7 ,+,*,= 
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Indicates horizontal calculation, which multiplies the numeric value of the fourth field 
by the numeric value of the sixth field and enters the product in the seventh field. 


ATOT, 102,C, 1,99 E F4,F5,F6 ,+,+,+ V1I4,V218,V318,V418 


Calculates the vertical total data in the fourth, fifth, and sixth fields and enters the 
results in V2, V3, and V4. Since there is an E option specified, the number of 
entries (data lines) are entered in V1. A result report is not created. 


V1 V2 V3 V4 


Writes the totals to the output area. 
aDSP,100,D,-0 


Displays the totals. 


5.1.41. @ULK (Unlock) Run Function 


The @ULK run function releases update control of the report that was locked by the 
@LOK run function. 


Format: 


aULK 


5.1.42. @UPD (Update) Run Function 


The @UPD run function updates the lines in the original report corresponding to the 
lines in the update results created by the @MAU or @SRU run functions. 


The report updated is the receiving report of the @MAU or the original report of the 
@SRU run function. 


Format: 


aUPD 


Example: 
@MAU, 102,C,1,102,B,2 M F1,F3 ,1,A F4,F6 ,1,A 


MATCH (UPDATE) the first field in the issuing report (102,C,1) against the fourth 
field in the receiving report (102,B,2). When a match occurs, move the matching 
line of the receiving report to the result. Then move the third field of the issuing 
report to the sixth field of the result. The M option specifies that only matching 
lines are to be included in the result. 
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aUPD 


Replace the matching lines in the receiving report with the corresponding lines from 
the update result. 


5.1.43. @WRL (Write Line) Run Function 


The @WARL run function writes data in up to 23 lines of a report. It uses either literal 
values or input from variables. When executing this function, it is necessary to lock this 
report in advance with the @LOK run function. 


Format: 


@WRL,mode, type,rid,start-line, identification], [password] 
characters [line-type],parameters 


where: 


mode 
Specifies the mode of the report to be written to. 


type 
Specifies the type of the report to be written to. 


rid 
Specifies the report number of the report to be written to. 


start-line 
Specifies the starting line number for writing. 


identification 
When Y is specified, do not update the time and user-id. 


password 
When specified, assigns or changes a report password. 


characters 


Specifies the fields, partial fields, or character columns in which to write the 
data. 


Line-type 
Specifies the line type designator to write to. The @WARL run function converts 
all updated lines to the line type specified in this subfield regardless of their 
original type. The default equals the tab type. 


parameters 
Specifies the data to write in the specified fields. 
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& NOTES: 


1. When writing multiple lines, delimit the line type and parameters of each line with 
slashes. 


2. If the specified line type and the original line type differ, the data content is not 
guaranteed. 


Example 1: 


Original report: 


























== 
































LINE> 1 FMT> RL> SHFT > HLD CHR> HLD LN> PSWD> > 
.DATE 83/07/05 10:47:50 TYPE=B RID=003 83/06/29 JDOE < 48 LINES» 
. <<< CORPORATE PRODUCTION STATUS >>> 

xST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC. 
*CD. DATE .IN. TYPE .NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD. 
ae SSSess ,F5 SS sessea= ,~RBSsSez,ssessesc Ssesors , Sass ,2Seeae5 TBS Sse  ,fesssese Serer ,ese, 


IP 741224 LS BLACKBOX1 436767 84389 AMCO 741223 741224 
IP 741225 LS BLACKBOX1 436768 84390 AMCO 741223 741225 
IP 741219 LS BLACKBOX2 637071 84353 INTR 741218 741219 
OR 750110 LS BLACKBOX4 94754 ARCO 

SC 750110 LS BLACKBOXS 675281 97441 FEDS 750131 





@ This run writes one line to the original report: 








@CHG V11A2 Al 

@CHG V12A6 810101 
@LOK,102,B,3 

QWRL,102,B,3,6 F1,F2 C,V11,V12 
@ULK 

@GTO END 





















































LINE> 1 FMT> RL> SHFT> HLD CHR> HLD LN> PSWD> 

-DATE 83/07/13 13:04:11 TYPE=B RID=003 83/07/13 MAPR < 48 LINES 
. <<¢ CORPORATE PRODUCTION STATUS >>> : 
*ST.STATUS.BY. PRODUCT .SERIAL.PRODUC.ORDER.CUST.PRODUC.PRODUC. SHIP .SHIP .SPC 
*CD. DATE .IN. TYPE NUMBER. COST .NUMBR.CODE. PLAN .ACTUAL. DATE .ORDER.COD 








Al 810101 LS BLACKBOX1 436767 84389 AMCO 741223 741224. 
IP 741225 LS BLACKBOX1 436768 84390 AMCO 741223 741225 
IP 741219 LS BLACKBOX2 637071 84353 INTR 741218 741219 
OR 750110 LS BLACKBOX4 94754 ARCO 

SC 750110 LS BLACKBOXS 675281 97441 FEDS 750131 
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Example 2: 


This run writes multiple lines to the original report. 
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@CHG V11A2 
@CHG V12A6 
@LOK ,102,B,3 


@ULK 
@GTO END 





Al CHG V21A2 A2 CHG V31A2 A3 


810101 CHG V22A6 820101 


@WRL,102,B,3,6 F1l,F2 €,V11,V12/0,V21,V22/0 ,V31i,V32 


CHG V32A6 830101 

















































































INE> 1 FMT> RL> SHFT> HLD 
DATE 83/07/13. 13:25:17 TYPE=B RID=003 
<<< CORPORATE PRODUCTION STATUS >>> 

. STATUS. BY. 
. DATE .IN. 


CHR> HLD LN> PSWD> 
83/07/13 MAPR < 


CUST.PRODUC.PRODUC. SHIP 
CODE. PLAN .ACTUAL. DATE 





> 
48 LINES> 


SHIP .SPC. 
. ORDER .COD. 


810101 LS 
820101 LS 
830101 LS 
750110 LS 
750110 LS 





PRODUCT .SERIAL.PRODUC.ORDER. 

TYPE -NUMBER. COST .NUMBR. 
BLACKBOX1 436767 84389 
BLACKBOX1 436768 84390 
BLACKBOX2 637071 84353 
BLACKBOX4 94754 
BLACKBOXS 675281 97441 


5.1.44. @XIT (Sign Off) Run Function 


AMCO 741223 741225 
INTR 741218 741219 
ARCO 

FEDS 750131 


The @XIT run function ends the run being executed and puts the workstation in the 
post sign-off state. An idle logo is then displayed on the workstation screen. 


Format: 


axIT 
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6. Run Creation Example 


6.1. GENERAL 


The example provided in this section calculates and displays grand totals of the quantity 
and value of the orders received and subtotals by customer. You have the option of 
printing the results on an auxiliary (AUX) printer. Two reports are included in this 
process: 


= Corporate Factors Base , report 102,C,1 



















= 





LINE> 1 FMT> RL> SHFT> HLD CHR> HLD LN> PSWD> > 
-DATE 83/06/29 13:07:49 TYPE=C RID=001 83/06/29 JDOE < 24 LINES> 
. <<< CORPORATE FACTORS BASE >>> 

x PRODUCT . SUB .PRODUC. WHOLE . RETAIL . SALES .SPACE. DEMO 


* TYPE  . KEY . COST . SALES . $$$$ .COMMISS. REQ .QUANTITY. DEMO RESULTS 
Ksesstrasss sstess ssssc= Sss2z2s-= sss2s225 ssssera sss sss2sse2z= SBSsessessaeasrssesssaa 
BLACKBOX1 A 13500 16875 23625 2362.50 100 1 

BLACKBOX2 A 13600 17000 23800 2380.00 110 2 

BLACKBOX3 A 13700 17125 23975 2397.50 120 4 

BLACKBOX4 B 13800 17250 24150 2415.00 130 10 

BLACKBOX5 B 13900 17375 24325 2432.50 140 50 

BLACKBOX6 C 14000 17500 24500 2450.00 150 100 

BLACKBOX7 C 14100 17625 24675 2467.50 160 10 

BLACKBOX8 D 14200 17750 24850 2485.00 170 20 

BLACKBOX9 D 14300 17875 25025 2502.50 180 40 

GREENBOX1 E 13700 17125 #23975 2397.50 200 80 

GREENBOX2 E 13900 17375 24325 2432.50 210 160 

GREENBOX3 E 14100 17625 #24675 2467.50 220 5 

GREENBOX4 F 14300 17875 25025 2502.50 230 15 

GREENBOX5S G 14500 18125 25375 2537.50 240 25 

GREENBOX6 H 14700 18375 25725 2572.50 250 1 

GREENBOX7 I 14900 18625 26075 2607.50 260 2 

GREENBOX8 J 15100 18875 26425 2642.50 270 3 

GREENBOX9 K 15300 19125 26775 2677.50 280 4 





= Corporate Order Status , report 102,D,1 


vEZL6-dN 


LINE> 1 FMT> RL» SHFT> HLD CHR> HLD LN> PSWD> > 

-DATE 83/07/05 09:29:51 TYPE=D RID=001 83/06/29 JDOE < 20 LINES> 

. <<< CORPORATE ORDER STATUS >>> 
ORDER . PRODUCT .ODR.CUST. UNIT .EXTENDED.REQ'D .SALE. - && 
.NUMBER. TYPE QTY. . RETAIL . RETAIL .DELIVR. : CUSTOMER .  * ADDRESS 


999515 GREENBOX9 AMCO : CENTRAL AV ORLEANS 
99951S GREENBOX7 1 AMCO . 750312 AMERIAN OIL CO. CENTRAL AV ORLEANS 
. 99951S BLACKBOX9 AMCO 750312 AMERIAN OIL CO. CENTRAL AV ORLEANS 
96652S GREENBOX4 ARCO 750412 ARGENTINE CORP. STH AVE YORK 
96652S BLACKBOXS ARCO 780412 ARGENTINE CORP. STH AVE YORK 
96652S BLACKBOX4 ARCO 750412 ARGENTINE CORP. STH AVE YORK 
997535 GREENBOXS DICO 750312 DIGITAL CORP NORTH ST YORK 
94525S GREENBOX8 FEDS 750312 FED SYSTEMS CORP COLUMBIA WASHINGTON 
967515 GREENBOX1 FEDS 760312 FED SYSTEMS CORP COLUMBIA WASHINGTON 
99842S BLACKBOX8 FEDS 760312 FED SYSTEMS CORP COLUMBIA WASHINGTON 
99842S BLACKBOX0 FEDS 760312 FED SYSTEMS CORP COLUMBIA WASHINGTON 
99752S BLACKBOX4 INTR 750312 INTERNATIONAL CO SUMMIT AV CHICAGO ILL 65320 
98782S BLACKBOX9 USSC 750312 UNION STEEL/SULFR 54 ALCAN AVE SEATTLE WASH 73001 
96755S GREENBOX9 USSC 760312 UNION STEEL/SULFR 54 ALCAN AVE SEATTLE WASH 73001 
END REPORT END REPORT 





SNOILLONN4 NOY O08 YaddvVW 
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UP-9734 





6.2. PROCESSING FLOW 
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Figure 6-1 shows the processing flow of the run. 


Obtains auxiliary device 
name for printing. 


Obtains retail price of each 
Product Type from the 
manufacturing Corporate 
Factors Base report. 


Calculates value of the 
orders received per Product 
Type. (Retail Price X Order 
Quantity = Extended Retail). 


Calculates overali total value 
of orders’ received and 
quantity of orders received. 


Calculates total order value 
and order quantity per 
customer. 


Displays results on the 
screen. 


Print results 





Figure 6-1. Processing Flow 


6-3 
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6.3. RUN DETAILS 


The run details are given in Figure 6—2. 





























LINE> 1 FMT> RL> SHFT> HLD CHR> HLD LN> 3 PSWD> > 

xCOLUMN NUMBER 
11111111112222222222333333333344444444445555555555666666666677777777778 

12345678901 2345678901 2345678901 2345678901 2345678901 2345678901 2345678901 234567890 


DATE 83/07/14 13:51:38 TYPE=G RID=018 83/07/13 JDOE < 39 LINES> 
.MAPPER80 RUN FUNCTION : RUN-NAME = RUNSTA : EXAMPLE (ORDER STATUS SUMMARY) 
Recess csesrssss ses sess sess esses sess ssr sr sss sess sess sss essere essssssesesssesseseses 
@BRK 

@SFS U100 /V1A3 . GET AUX NUMBER 

@CHG V2H6 DATE1S . GET DATE 

@CHG V3A2 V2(1-2) CHG V4A2 V2(3--2) CHG VSAZ V2(5-2) . EDIT DATE 

@CHG V11H8 TIMES . GET TIME 


ORDER STATUS SUMMARY 
DATE: V3/V4/V5 TIME: V11 


@MCH,102,C,1,102,D,1 '' F1l,F5 ,1,A F3,F6 ,1,A . GENERATE RESULT FROM 1D. 

a. . INCLUDE RETAIL PRICE 

@. . FROM 1C 

@TOT,102,D,-0 ‘' F4,F6,F7 ,*,+,2 . MULTIPLY RETAIL PRICE 

@. . BY NUMBER OF ORDERS. 

@RNM -1 . SAVE RESULT 

@TOT,102,D,-1 '' F4,F7 .+,+ V1313,V1416 . TOTALIZE NUMBER OF 

@. . . ORDERS AND RETAIL SALES. 
CUSTOMER ORDER QTY RETAIL SALES 





@SUB,102,D,-1 '' F4,F7,F10 ,+,+,S V1513,V1618,V17S17 . SUBTOTAL BY CUSTOMER 
v17 v15 v16 


TOTALS V13 ORDERS $V14 SALES 
@BRK 
@DSP 102 ,G,-0 . DISPLAY THE RESULT 
@IF Vi = ' ' GTO 99 . TEST IF RESULT IS TO 
@. . BE PRINTED ON AUX. 
@AUX,102,G6,-0,V1,,Y . PRINT RESULT ON AUX V1 
@99:XIT . SIGN OFF 

ee END REPORT ..... 


























Figure 6-2. Run Details 
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6.4. RUN EXECUTION 


Run execution first requires starting the run. Refer to 4.2.1 through 4.2.3. This consists 
of entering the @RUN run function followed by the run name: 


@RUNSTA. 


When the run starts, the following screen format services screen appears: 





























<<< ORDER STATUS SUMMARY >>> 





IF YOU WANT TO PRINT, PLEASE ENTER THE AUXILIARY DEVICE ID: (___) 





To print the displayed result on the auxiliary (AUX) printer, key in the auxiliary printer 
name (format=Pxx) and transmit. If the display is not to be printed, leave the field blank 
and transmit. After transmitting, the run resumes and performs the required calculations 
and displays the result on the screen. 




















LINE >1 FMT> RL> SHFT > HLD CHR> HLD LN> PSWD> '‘RESULT''> 
DATE 83/07/14 12:54:20 TYPE=G RID= 83/07/14 JDOE < 19 LINES> 


ORDER STATUS SUMMARY 
DATE: 83/07/14 TIME: 12:53:55 


CUSTOMER ORDER QTY RETAIL SALES 
AMERTIAN OIL CO. 4 104650 
ARGENTINE CORP. 4 98525 
DIGITAL CORP 1 25375 
FED SYSTEMS CORP 4 78250 
INTERNATIONAL CO 1 24150 
UNION STEEL/SULFR 2 51800 

TOTALS : 16 ORDERS $379750 SALES 

auc ieuene END REPORT ..... 





Key in RSM and transmit. The run resumes and, based on the response entered in the 
SFS screen display, decides if the results are to be printed on the auxiliary printer. 


If the SFS screen response contained an auxiliary name, the run prints the result on the 
AUX printer, then terminates and signs off. 


lf the SFS screen response was blank, the run terminates and signs off. 
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Appendix A. Run Function Summary 


The run functions are shown in A.1 through A.7. 


A.1. REPORT UPDATE FUNCTIONS 


@ADD 
@ADR 


@BRK 


@DLR 
@DUP 
@REP 


@RNM 


Creates a result by appending one report to another. 
Creates a new report. 


Converts data in output area to a result, erases the contents of the output 
area, and reopens it. 


Deletes reports. 
Duplicates reports. 
Replaces one report with the contents of another report. 


Renames report or result (-O) to a temporary —1 to —4 result name. 


A.2. LINE UPDATE FUNCTIONS 


@DEL 
@LIN 

@LNX 
@LN+ 
@LN- 
@RDC 


@RDL 


Deletes lines of the original raped corresponding to the update result lines. 
Obtains line number of the last line of the report. 

Duplicates lines in the report. 

Adds lines to the report. 

Deletes lines from the report. 


Reads multiple lines in the report continuously and writes that data in the 
output area. 


Reads one line from a report. 


UP-9734 


@RLN 


@UPD 


@WAL 
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Reads the next line of a report. 


Updates lines of the original report corresponding to the lines of the update 
result. 


Writes data in a report. 


A.3. QUERY FUNCTIONS 


@BFN 
@FND 


@LCH 


@MAU 


@MCH 
@SOR 
@SRH 
@SRU 


Finds data in a report by means of the binary division method. 
Finds specified data in the report. 


Produces a result by locating a certain character string in the report and 
replacing it with another character string. 


Matches two reports and produces a result that can be used to update the 
receiving report. 


Matches two reports and produces a result. 
Sorts data in the report. Produces a result. 
Finds all specified data in the report and produces a result. 


Finds all specified data in the report and produces a result that can be used to 
update the original report. 


A.4. CALCULATION FUNCTIONS 


@CHG 
@SUB 


@TOT 


Changes contents of a variable. 
Prepares subtotal of data in the report. 


Performs arithmetic operations. 


A.5. WORKSTATION DISPLAY FUNCTIONS 


@DSP 


@SFS 


Displays the report at the workstation. 


Displays the format screen prepared by screen format services at the 
workstation. 
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A.6. RUN END FUNCTIONS 


@GTO END Completes the run and displays the contents of the output area on the 


@REL 


@XIT 


screen. 
Ends run (goes into SIGN ON state, user logo displayed). 


Ends run (goes into SIGN OFF state, idle logo displayed). 


A.7. OTHER FUNCTIONS 


@AUX Prints report or result on the named auxiliary printer. 


@COP 
@ESR 
@GTO 
@IF 
@IND 
@INS 
@LOK 


@PRT 
@RSR 
@RUN 


@ULK 


Prints report or result on the COP printer atttached to the workstation. 
Returns from a subroutine. 

Performs branching. 

Compares and assesses variable data. 

Creates report index in the specified type. 

Inserts data into variable. 


Prevents other users from updating the same report that the current run is 
updating. 


Prints report on the system printer. 
Executes a subroutine. 
Ends run being executed and starts execution of a different run. 


Releases lock on report. 
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Appendix B. Options Table 


Deletes search or match lines ‘om the 
result. 
| Rounds down answer to nearestn. down answer to nearest n. om seen 


| Counts number of entries. =| number of entries. 
Processes the first column of the mask 
parameter as part of the character string. 
Leaves original data in the receiving X 
field of the unmatched lines. 

H Displays the header line only of the 
initial report of the multiple reports 
searched. 
Deletes the index and item name of the 
total, subtotal, and average. 


Substitutes line type when a 
substitution occurs in the line. 
Pm Displays the matched lines only. 






o027® 
rOrEe 


IQOZQ®~CPFrz2O 
















Displays data other than the specified 
parameter. 
Displays the unmatched lines only. 


Displays total, average, and subtotal 
lines only. 
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| Run instruction =| Instruction 


Indicates that the key field has been 
sorted. 


senowoeiwmmnee txt | | | | | | 
isi eal 
Searches multiple reports. 


Specifies starting line number for 
scanning. 
Sets transparent character to x. 


Displays vertical summations, averages, 
and subtotals as tab line — lines when 
used in combination with the V option. 


oe Rounds up answer to nearest n. 










LOCT® 
® 
4048 


INZ@O~CcPr 









Displays total, average, and subtotal 

under each item header. 

Blank fields xX | 
Process slashes (/) as a part of the Xx 
character string. 


Ese 
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Appendix C. Correspondence Between Run 
Functions and Manual Functions 


Run Corresponding 
Functions Manual Functions 


@ADD ADON 

@ADR AR 

@AUX AUX 

@BFN BF 

@COP COP 

@DEL —OBEL 

@DLR DR 

@DSP D 

@DUP XR 

@FND F 

@IND | 

@LCH CHG 

@LNX >]gXn (Duplicate line.) 
@LN+ D]g+n (Add line.) 


@LN- >]g— (Delete line.) 
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Run Corresponding 
Functions Manual Functions 
@MAU MAU 

@MCH MA 

@PRT PR 

@REL IK 

@REP REP 

@RUN RUN 

@SOR SORT 

@SRH S 

@SRU SU 

@TOT TOT 

@UPD UPD 

@WRL > *** *** 7 (SOE update) 


@XIT Xx 








Term 


@ @ADR (add report) 


Branching 


UP-9734 SPERRY OS/3 Index 1 
MAPPER 80 RUN FUNCTIONS 
Index 
Reference Page Term Reference Page 
Cc 
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§.1.2 5-2 
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Conditional run statement 5.1.15 5-18 
@AUX (auxiliary device) 5.13 §-3 
@COP (COP device) 5.1.7 5-10 
Auxiliary printer 5.1.7 5-10 
Creation of run 1.2 1-2 
Fig. 1-2 1-2 
D 
@BFN (binary find) 5.1.4 5-4 Data format (output) 2.1.4 2-11 
5.1.14 5-16 DATA types processed 
description 3.2 3-1 
@BRK (break) §.1.5 5-6 regular reports 3.3 3-1 
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results 3.4 3-1 
run output area 3.5 3-4 
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Debugging a run 1.4.4 1-8 @GTO (branch) 5.1.14 5-16 
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DLINE$ Table 2-2 = 2-13 
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L 
@LCH (locate and change) 5.1.18 5-23 
E LINE$ Table 2-2 = 2-13 
@ESR (exit subroutine) Se gag | Bay; aes 
Execution of a run 1.2 1-2 ns Table 2-2 2-15 
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F 
FMT$ Table 2-2 2-13 
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Appendix C 


UP-9734 SPERRY OS/3 Index 4 
MAPPER 80 RUN FUNCTIONS 








Term Reference Page Term Reference Page 
Ss 
U 
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@SOR (sort) 5.1.36 5-43 colon method 2.1.3.2.1 2-8 
methods 2.1.3.2 2-8 
@SRH (search) 5.1.37 5-44 run function method 2.1.3.2.3 2-9 
@SRU (search update) 5.1.38 5-45 Variable formats defined 
type A 2.1.3.1 2-7 
STATI Table 2-2 = 2-13 type F 213.1 2-7 
type H 2.1.3.1 2-7 
STAT2 Table 2-2. = 2-13 type | 213.1 2-8 
type S 2.1.3.1 2-8 
STNUM$ Table 2-2. = 2-13 
Variable initialization and manipulation 2.1.3.3 2-9 
Style conventions 
capital letters 2.1.1 2-1 
run function syntax 2.1.1 2-1 
2.1.2 229 WwW 
@SUB (subtotal) 5.1.39 5-46 Workstation display 
at termination 4.3.2 4-5 
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@TOT (totalize) 5.1.40 5-49 
TYPE$ Table 2-2 2-13 X 
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